Skip to content

API reference / Lookup

Get a vehicle by lot number

GET/search-lot/{lot}/{domain}

Retrieve a vehicle and its matching auction records with a Copart or IAAI lot number. Searches active and archived listings.

  • Pass the source lot number from lots[].lot as {lot} and copart_com or iaai_com as {domain}. The lot number is a source identifier, distinct from data.id and lots[].id.
  • For a source external vehicle ID, such as the IAAI ID in a listing URL, set search_by_id=1 and pass that ID as {lot}. Numeric external IDs use prefix matching; nonnumeric ones must match exactly.
  • Returns HTTP 400 for an invalid lot format, HTTP 401 for a source unavailable to your account and HTTP 404 when nothing matches.
  1. Change the values below
  2. The request on the right updatesThe request above updates
  3. Run it live with your key

Path parameters

string · required

Source lot number: digits with an optional final letter. Use the source external ID instead only when search_by_id=1. This is not the internal record ID.

string · required

Source platform: copart_com for Copart or iaai_com for IAAI.

Query parameters 2

integer · 0–1

Set 1 to include the prices history array for each lot. Omit or use 0 for the standard response.

integer · 0–1

Set 1 to interpret {lot} as external_id (for example the IAAI vehicle ID in its URL). Numeric external IDs use prefix matching; nonnumeric ones an exact match.

© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.