Inventory

Get a listing

Get one listing by listing_id (the id of a /v1/listings result): price, mileage, photos, pricing line items, dealer contact, and the vehicle's build. Use GET /v1/vins/{vin} when you have a VIN instead. A listing_id that no longer resolves returns the same vehicle's current listing, else its latest sold listing, with requested_listing_id set to the id you asked for. Otherwise it returns 404 not_found_error.

Required API key scope: inventory.read. Billable as vehicle_detail, or vehicle_detail_enriched with include. Each response reports its metering class and cost in the X-Usage-Class and X-Usage-Cost-Micros headers.

get/v1/listings/{listing_id}

Request

  • Base URL: https://api.visor.vin
  • URL: https://api.visor.vin/v1/listings/{listing_id}
  • Auth: HTTP bearer

Path parameters

listing_idstring required

Listing ID, the id field of a /v1/listings result.

Query parameters

includestring[]

Comma-separated optional expansions. Supported values are price_history and options.

Response

Successful public API response.

metaobject required

Reserved metadata object. It is empty for the beta contract unless an endpoint documents otherwise.

Changes

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