latestOpenAPI 3.0.02026-08-081413373.1 KB

8fb62eeae60e

listings

get/listings/{vin}

Path parameters

vinstring required

Vehicle Identification Number

Example:1HGCM82633A123456

Query parameters

createdAtstring

Filter by listing creation time (UTC). Accepts a truncated-datetime range: "2026-06-13-2026-06-15" (the 13th through the 15th, inclusive), a single whole period "2026-06" (all of June) or "2026-06-13" (that day), or an open-ended bound "2026-06-13-" (since) / "-2026-06-15" (until). Each side may be any precision: YYYY, YYYY-MM, YYYY-MM-DD, or YYYY-MM-DDTHH:MM:SS. The upper bound is inclusive of its whole period.

distancenumber

Search radius in miles (default: 50)

includeUnpricedstring

Opt in to listings without a real retail price. Default excludes them. Opted-in rows emit retailListing.price as null (never 0). Pass true or 1.

includesstring

Comma-separated includes, e.g. "facets"

limitnumber

Results per page (default: 100)

pagenumber

Page number (default: 1)

retailListing.milesstring

Filter by mileage. Supports a numeric range, e.g. "0-50000".

retailListing.pricestring

Filter by price. Supports a numeric range, e.g. "20000-30000", "20000-" (min), or "-30000" (max).

sortstring

Sort field and direction, e.g. "price:desc", "mileage:asc", "year:desc"

updatedAtstring

Filter by listing last-updated time (UTC). Same range syntax as createdAt.

vehicle.bodyStylestring

Filter by body style

vehicle.drivetrainstring

Filter by drivetrain

vehicle.exteriorColorstring

Filter by exterior color

vehicle.fuelstring

Filter by fuel type. Use .not suffix to exclude.

vehicle.interiorColorstring

Filter by interior color

vehicle.makestring

Filter by vehicle make. Use .not suffix to exclude.

vehicle.modelstring

Filter by vehicle model. Use .not suffix to exclude.

vehicle.transmissionstring

Filter by transmission type

vehicle.trimstring

Filter by trim level

vehicle.yearstring

Filter by vehicle year

zipstring

ZIP code for location-based search

Response

Success

dataRow[] required
facetsobject
totalnumber
totalFormattedstring