details

Catalog-shaped search alias (JSON body)

post/api/listVehicles

Request

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

Request body

manufacturer_slugstring
manufacturerstring
brandstring
model_group_slugstring
model_groupstring
modelstring
fuel_typestring
fuelstring
steering'left' | 'lhd' | 'left-hand' | 'left_hand' | 'right' | 'rhd' | 'right-hand' | 'right_hand'

See the steering query parameter.

orderingstring
min_yearinteger
max_yearinteger
max_mileageinteger
limitinteger
offsetinteger
pageinteger
page_sizeinteger

Response

Matching vehicles. vehicles and results are the same array.

successboolean required
contract_versionstring

Matches info.version of this document.

request_idstring

Also returned as the X-Request-ID header.

server_timestring date-time

UTC ISO-8601 timestamp of the response.

data_updated_atstring date-time

Route-supplied data timestamp, falling back to server_time. Not a guaranteed source refresh time; inspect listing observation timestamps and live_price.fetched_at where available.

totalinteger nullable

null when totals are suppressed or could not be computed.

limitinteger
offsetinteger
pageinteger
page_sizeinteger
total_pagesinteger nullable

null when total is null.

max_pageinteger nullable

Deepest page reachable under the offset policy.

Example response

{
  "success": true,
  "contract_version": "2026-09-03",
  "vehicles": [
    {
      "auction_id": 38112900,
      "site_name": "openlane",
      "clean_make": "BMW",
      "clean_model": "320d",
      "model_display": "320d M Sport",
      "registration_year": 2020,
      "production_year": 2019,
      "production_month": 11,
      "mileage": 45000,
      "fuel_group": "Diesel",
      "gearbox_group": "Automatic",
      "steering": "left",
      "public_price_eur": 21500,
      "auction_end_at": "2026-08-20T10:00:00Z",
      "country_code": "DE",
      "auction_id_str": "38112900"
    }
  ],
  "results": [
    {
      "auction_id": 38112900,
      "site_name": "openlane",
      "clean_make": "BMW",
      "clean_model": "320d",
      "model_display": "320d M Sport",
      "registration_year": 2020,
      "production_year": 2019,
      "production_month": 11,
      "mileage": 45000,
      "fuel_group": "Diesel",
      "gearbox_group": "Automatic",
      "steering": "left",
      "public_price_eur": 21500,
      "auction_end_at": "2026-08-20T10:00:00Z",
      "country_code": "DE",
      "auction_id_str": "38112900"
    }
  ]
}

Changes

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