Marketcheck Home

Auction Listing Details

Retrieve comprehensive details about specific auction vehicle listings with complete vehicle specifications, auction house information, media content, and marketplace data.

Retrieve detailed information about specific automotive auction listings using their unique listing identifier.

Base Path

GET https://api.marketcheck.com/v2/listing/car/auction/{listing_id}

Path Parameter:

  • listing_id - The unique identifier for the auction listing you want to retrieve. This parameter is case-sensitive and must be provided in the URL path.

The following example illustrates how to use the API to retrieve auction listing details:

request.js
import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/car/auction/W1N0J6EB2PG149336-d084e6e2-cd31',
  params: {api_key: 'YOUR_API_KEY'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Request

Parameters

Available parameters for retrieving detailed auction listing information:

1 Params
api_key
string required

Your MarketCheck API authentication key. Required for every request, unless OAuth is used.

Required Parameters

  • listing_id (path parameter) - The unique listing identifier

Response

The Auction Listing Details API returns detailed information about the specified auction listing in a structured JSON format.

Schema

The response schema for Auction Listing Details is identical to the Car Listing Details API, but focuses on auction listings. The data structure includes all the same vehicle specifications, pricing information, and media content, but with auction house-specific seller information and marketplace context appropriate for wholesale auction listings.

Refer to the Car Listing Details API response schema for complete field definitions, data types, and detailed descriptions of all response components.

Success Response

  • 200 OK - Returns detailed JSON object with complete auction listing information
  • Includes vehicle specifications, pricing data, auction house information, and media content
  • Provides data suitable for auction listing display and wholesale market analysis

Error Response

Status CodeDescriptionCommon Causes
400Bad RequestInvalid parameter values
401UnauthorizedMissing/invalid API key
403ForbiddenAccess denied to resource
422Unprocessable EntityInvalid listing_id
429Too Many RequestsRate limit exceeded
500Internal Server ErrorTemporary server issues
502Bad GatewayIssues with upstream services
503Service UnavailableAPI maintenance or downtime

Use Cases & Examples

Wholesale Market Analysis

Retrieve detailed information about auction listings to analyze wholesale market trends, pricing patterns, and vehicle availability for acquisition and resale decisions.

Example:

Here we're retrieving complete details for a specific auction listing including specifications, pricing, auction house information, and marketplace data:

request.js
import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/car/auction/5TFRM5F10FX089674-18e6d270-7a2c',
  params: {api_key: 'YOUR_API_KEY'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

See Also