details

Full detail payload by source and identifier

Fetch or serve detail for auto1, openlane, schadeautos, copart, encar, kbchachacha or ecarstrade. KB requires numeric carSeq. Japan is not accepted: use /api/auction/japan/{auction_id} for stored import data. Responses are source-shaped; prefer vehicle_details for normalized fields. Details and price fields are subject to the key grants.

get/api/car-details

Request

  • Base URL: https://api.thecarapi.com
  • URL: https://api.thecarapi.com/api/car-details
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer
    • API key in query parameter api_key

Query parameters

site'auto1' | 'openlane' | 'schadeautos' | 'copart' | 'encar' | 'kbchachacha' | 'ecarstrade' required

Detail fetcher source. Japan is not supported here.

idstring
Example:38112900

Source id. Required unless link or identifier is given. For auto1 this is the offer id/UUID, not the numeric auction id.

linkstring uri

Listing URL. An alternative to id.

identifierstring

Source id or listing URL. An alternative to id.

search_idstring

Optional correlation id, echoed for your own tracing.

Response

The detail payload.

successboolean
site'auto1' | 'openlane' | 'schadeautos' | 'copart' | 'ecarstrade' | 'encar' | 'kbchachacha' | 'japan'

Implemented inventory sources. /api/sites returns deployed sources and counts visible to your key. Japan has stored detail only. European classifieds use separate endpoints.

auction_idinteger nullable
details_pendingboolean

true when the on-demand fetch exceeded its timeout and is still running in the background. Poll; do not retry in a tight loop.

steering'left' | 'right' nullable

Which side the steering wheel is on, same derivation and same top-level spelling as /api/auction/{site_slug}/{auction_id}. null only when the vehicle is not in our inventory, which leaves no country to derive it from.

start_pricenumber nullable
current_pricenumber nullable
current_finalnumber nullable
current_taxnumber nullable
current_tax_deliverynumber nullable
buy_now_pricenumber nullable
buynow_finalnumber nullable
buynow_taxnumber nullable
buynow_tax_deliverynumber nullable
final_pricenumber nullable
public_price_eurnumber nullable
current_bgnnumber nullable
buynow_bgnnumber nullable
estimated_value_eurnumber nullable

The auction house's own valuation of the vehicle in EUR — not a price you can pay and not a figure any bid is settled against. Today only ecarstrade publishes one (its "eCT Estimation Price"); it is null for every other source, and may be null on eCarsTrade lots that have no estimate.

Where it does appear it is often the only number on the lot: blind auctions hide the bid, so current_price, start_price and buy_now_price are all null while this carries the house's estimate. Treat it as a valuation signal, never as a price.

live_price_pendingboolean
auctionobject

Not the vehicle record. For openlane this is {"extracted_fields": {"images": [...]}}, an image container that shares a name with the detail endpoint's vehicle wrapper and nothing else. Read prices from the top level here.

imagesobject[]
detailsobject
dataobject

Example response

{
  "site": "openlane",
  "live_price": {
    "price": 25900,
    "currency": "EUR",
    "source": "openlane",
    "fetched_at": 1786659750
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.