DokumentimiReferencaLista e automjeteve

Lista e automjeteve

GET/cars

x-api-key46 query

Vehicles with active lots from every source enabled for your key, filtered and paged (50 per page by default; use page for the next results). Add minutes to get only recent changes. Each vehicle may contain lots[].seller_reserve. Seller reserve price, when available. Object with price (reserve amount) and updated_at (last reserve update timestamp, or null); seller_reserve is null when no reserve is available. This is not the current bid or a confirmed final sale price. Read it from the relevant lot. Example: {"price":8500,"updated_at":"2026-09-13T10:30:00.000000Z"}.

Parametrat

domain_idqueryinteger

Source platform ID: 1=IAAI, 3=Copart, 12=Encar. Omit to use sources enabled for the key. Send one integer, not an array. Unsupported IDs return 400; sources outside your access return 401.

minutesqueryinteger

this parameter allows you to retrieve only those cars that have been updated in the last few minutes (max 4320 minutes)

Diapazoni: 1–4320

per_pagequeryinteger

Vehicles per page. Default: 50. Use page for the next results.

Parazgjedhur: 50Diapazoni: 1–1000

pagequeryinteger

Optional page number, starting at 1 (default). Keep filters unchanged when requesting subsequent pages.

Parazgjedhur: 1Diapazoni: 1–…

manufacturer_idquerystring

Manufacturer ID(s) (number, comma-separated for multiple values, e.g. 16,88,...). To get the ID, use the /manufacturers endpoint.

model_idqueryinteger

Car model id, to get it use /models endpoint

generation_idqueryinteger

Car generation id, to get it use /generations endpoint

from_yearqueryinteger

Filter from specific year

Përgjigjet

  • 200A list of all cars
  • 400Invalid request parameter or page size. Correct the request before retrying.
  • 401Requested source is not enabled for this key.
  • 403Missing, invalid, expired or inactive API key.
  • 429Request rate limit reached. Respect Retry-After if provided.
  • 500Unexpected server error. Retry safe reads with a bounded budget.

Përshkrimet e fushave vijnë nga specifikimi OpenAPI, në anglisht.