details

Full detail payload by source and identifier (JSON body)

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.

post/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

Request body

OR
OR

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.