Dealers

Search dealers

Find dealers by state, country, type, franchise make, dealer group, dealer_id, or a name and website search (q). Returns dealer summaries ordered by active listing count. Use GET /v1/dealers/{dealer_id} for phone, address, and sales hours, and GET /v1/dealers/{dealer_id}/listings for a dealer's inventory. listing_count counts each VIN once, at the dealer Visor attributes it to, so it can differ from the dealer's own website.

Required API key scope: dealers.read. Billable as dealer_lookup. Each response reports its metering class and cost in the X-Usage-Class and X-Usage-Cost-Micros headers.

get/v1/dealers

Request

  • Base URL: https://api.visor.vin
  • URL: https://api.visor.vin/v1/dealers
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size. Defaults to 50; maximum 100.

offsetinteger

Zero-based page offset. Defaults to 0.

dealer_idstring[]

Comma-separated dealer UUIDs to fetch directly. Accepts up to 100 dealer IDs.

dealer_group_idstring[]

Comma-separated current dealer-group IDs. Accepts up to 100 dealer-group IDs.

statestring[]

Comma-separated two-letter dealer states, for example CA,TX.

countrystring

Dealer country code, for example US.

type'franchise' | 'independent'

Dealer type.

makestring[]

Comma-separated represented franchise makes or slugs, for example toyota,honda.

qstring

Case-insensitive dealer name, website domain, or dealer-group name search string.

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.