GET /listings/{vin}

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.

Search radius in miles (default: 50)

Opt in to listings without photos. Default excludes them. Opted-in rows emit retailListing.primaryImage as null. Pass true or 1.

Opt in to listings without a dealer page link. Default excludes them. Opted-in rows emit retailListing.vdp as null. Pass true or 1.

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.

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

Results per page (default: 100)

Page number (default: 1)

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

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

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

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

Filter by body style

Filter by drivetrain

Filter by exterior color

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

Filter by interior color

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

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

Filter by transmission type

Filter by trim level

Filter by vehicle year

ZIP code for location-based search