Dealers

List a dealer's inventory

List one dealer's listings, with the GET /v1/listings filters, sort, fields, and pagination. For several dealers or a dealer group, use GET /v1/listings with dealer_id or dealer_group_id. Each VIN appears once, at the dealer Visor attributes it to.

Required API key scope: inventory.read. Billable as dealer_inventory_search, or its historical (sold, snapshot_date) and enriched (include) variants. Each response reports its metering class and cost in the X-Usage-Class and X-Usage-Cost-Micros headers.

get/v1/dealers/{dealer_id}/listings

Request

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

Path parameters

dealer_idstring uuid required

Dealer UUID, the dealer_id field of a dealer or listing result.

Query parameters

limitinteger

Page size. Defaults to 50; maximum 100.

offsetinteger

Zero-based page offset. Defaults to 0.

sort'days_on_market' | '-days_on_market' | 'listed_at' | '-listed_at' | 'price' | '-price' | 'miles' | '-miles' | 'msrp' | '-msrp' | 'discount' | '-discount' | 'distance'

Sort order. Use field names with optional - for descending, for example price or -price. Defaults to days_on_market (newest listings first) for active listings and to most recently sold first for sold listings. listed_at sorts by the first time Visor observed the listing. discount returns best discount from MSRP first. distance requires postal_code or latitude and longitude.

fieldsstring[]

Comma-separated public listing summary fields to return. This controls response projection only; filter-only parameters do not belong in fields. id and vin are always returned. Use default to include the default listing summary fieldset plus selected extras. Unknown fields are rejected. Supported fields: default, id, vin, year, make, model, trim, version, body_type, drivetrain, fuel_type, powertrain_type, transmission, engine, cylinders, doors, seating_capacity, exterior_color, interior_color, base_exterior_color, base_interior_color, spec_source, original_market, msrp, discount_from_msrp, price, miles, days_on_market, listed_at, last_checked_at, status, inventory_status, availability_status, inventory_type, stock_number, vdp_url, sold_date, dealer_id, dealer_name, dealer_type, city, state, postal_code, latitude, longitude, distance_miles, photo_urls, features, upfitters, options_packages.

includestring[]

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

makestring[]

Comma-separated make names or slugs, for example toyota,honda. Values: GET /v1/facets?facets=make.

modelstring[]

Comma-separated model names or slugs. Combine with make when possible for narrower results. Values: GET /v1/facets?facets=model.

model_codestring[]

Comma-separated manufacturer model codes. Values: GET /v1/facets?facets=model_code.

trimstring[]

Comma-separated trim names. Values: GET /v1/facets?facets=trim.

yearinteger[]

Comma-separated model years, for example 2023,2024.

statestring[]

Comma-separated two-letter dealer states, for example CA,TX. Values: GET /v1/facets?facets=state.

dealer_typestring[]

Comma-separated dealer types, for example franchise,independent.

availability_statusstring[]

Comma-separated availability statuses: stock, transit, build.

inventory_typestring[]

Comma-separated inventory classes: new, used, certified. cpo is accepted as an alias for certified.

body_typestring[]

Comma-separated body types. Values: GET /v1/facets?facets=body_type.

transmissionstring[]

Comma-separated transmission values, case-insensitive: Automatic, CVT, Manual.

drivetrainstring[]

Comma-separated drivetrain values, case-insensitive: AWD, FWD, 4WD, RWD.

assembly_locationstring[]

Pipe-separated assembly locations. Uses | because locations often contain commas. Values: GET /v1/facets?facets=assembly_location.

assembly_countrystring[]

Comma-separated assembly country values. Values: GET /v1/facets?facets=assembly_country.

original_marketstring[]

Comma-separated original markets read from the window sticker, case-insensitive: us, canada.

fuel_typestring[]

Comma-separated fuel type values, case-insensitive: Gas only, Hybrid, Diesel, Full Electric, Plug-in Hybrid, Flex-fuel, Biodiesel, Fuel Cell Electric, Natural Gas (CNG), LPG, Other.

powertrain_typestring[]

Comma-separated powertrain type values, case-insensitive: Combustion, HEV, MHEV, BEV, PHEV, FCEV, EREV.

enginestring[]

Comma-separated engine descriptions. Values: GET /v1/facets?facets=engine.

versionstring[]

Comma-separated vehicle version values. Values: GET /v1/facets?facets=version.

exterior_colorstring[]

Comma-separated exterior color values. Values: GET /v1/facets?facets=exterior_color.

interior_colorstring[]

Comma-separated interior color values. Values: GET /v1/facets?facets=interior_color.

base_exterior_colorstring[]

Comma-separated normalized exterior color values (Tan also matches Beige, Burgundy also matches Red), case-insensitive: Black, White, Silver, Gray, Red, Blue, Green, Yellow, Orange, Brown, Tan, Beige, Gold, Purple, Burgundy.

base_interior_colorstring[]

Comma-separated normalized interior color values (Tan also matches Beige, Burgundy also matches Red), case-insensitive: Black, White, Silver, Gray, Red, Blue, Green, Yellow, Orange, Brown, Tan, Beige, Gold, Purple, Burgundy.

seating_capacityinteger[]

Comma-separated seating capacity integers.

cylindersinteger[]

Comma-separated cylinder count integers.

doorsinteger[]

Comma-separated door count integers.

options_packagesstring[]

Comma-separated manufacturer option/package codes. Values: GET /v1/facets?facets=options_packages.

option_slugstring[]

Comma-separated source-stable option slugs. Additive to options_packages; package-code semantics are unchanged.

exclude_option_slugstring[]

Comma-separated source-stable option slugs to exclude.

featuresstring[]

Comma-separated feature tokens. Values: GET /v1/facets?facets=features.

upfitterstring[]

Comma-separated post-production upfitter ids; matches listings carrying any of them. Factory editions such as the Shelby GT500, the Mustang RTR package, or the AT4X AEV Edition are trims or options, not upfitters. Values: aev (AEV), airstream (Airstream), ams_vans (AMS Vans), armored (Armored (B4-B7)), brabus (Brabus), braunability (BraunAbility), callaway (Callaway), dinan (Dinan), driverge (Driverge), explorer_van (Explorer Van), fox_factory (Fox Factory), fr_conversions (FR Conversions), freedom_motors (Freedom Motors), harley_davidson (Harley-Davidson Edition), hennessey (Hennessey), lingenfelter (Lingenfelter), mansory (Mansory), midwest_automotive (Midwest Automotive Designs), ogv (OGV Luxury Coach), overfinch (Overfinch), revability (RevAbility), rocky_ridge (Rocky Ridge), rollx (Rollx Vans), roush (Roush), rtr (RTR), saleen (Saleen), sca_black_widow (Black Widow (SCA Performance)), shelby_american (Shelby American), sherrod (Sherrod), singer (Singer), storyteller (Storyteller Overland), tuscany (Tuscany), urban_automotive (Urban Automotive), vmi (VMI), waldoch (Waldoch), winnebago (Winnebago).

keywordsstring[]

Comma-separated provenance/history keyword tokens. Supported values: one_owner, clean_title, branded, fleet. Positive tokens must be present; negative history tokens are excluded.

vin_patternstring[]

Comma-separated VIN masks, up to 10 distinct patterns. VIN characters match themselves, ? matches one VIN position, and * is allowed only at the end. Short masks are treated as prefixes, for example 1HG or 1HGCM826*.

exclude_makestring[]

Comma-separated makes to exclude. Values: GET /v1/facets?facets=make.

exclude_modelstring[]

Comma-separated models to exclude. Values: GET /v1/facets?facets=model.

exclude_trimstring[]

Comma-separated trims to exclude. Values: GET /v1/facets?facets=trim.

exclude_yearinteger[]

Comma-separated model years to exclude.

exclude_statestring[]

Comma-separated dealer states to exclude. Values: GET /v1/facets?facets=state.

exclude_inventory_typestring[]

Comma-separated inventory classes to exclude: new, used, certified. cpo is accepted as an alias for certified.

exclude_body_typestring[]

Comma-separated body types to exclude. Values: GET /v1/facets?facets=body_type.

exclude_transmissionstring[]

Comma-separated transmission values to exclude, case-insensitive: Automatic, CVT, Manual.

exclude_drivetrainstring[]

Comma-separated drivetrain values to exclude, case-insensitive: AWD, FWD, 4WD, RWD.

exclude_versionstring[]

Comma-separated vehicle versions to exclude. Values: GET /v1/facets?facets=version.

exclude_enginestring[]

Comma-separated engine descriptions to exclude. Values: GET /v1/facets?facets=engine.

exclude_assembly_locationstring[]

Pipe-separated assembly locations to exclude. Uses | because locations often contain commas. Values: GET /v1/facets?facets=assembly_location.

exclude_assembly_countrystring[]

Comma-separated assembly countries to exclude. Values: GET /v1/facets?facets=assembly_country.

exclude_original_marketstring[]

Comma-separated original markets to exclude (listings with no known original market are kept), case-insensitive: us, canada.

exclude_exterior_colorstring[]

Comma-separated exterior colors to exclude. Values: GET /v1/facets?facets=exterior_color.

exclude_interior_colorstring[]

Comma-separated interior colors to exclude. Values: GET /v1/facets?facets=interior_color.

exclude_base_exterior_colorstring[]

Comma-separated normalized exterior colors to exclude (Tan also matches Beige, Burgundy also matches Red), case-insensitive: Black, White, Silver, Gray, Red, Blue, Green, Yellow, Orange, Brown, Tan, Beige, Gold, Purple, Burgundy.

exclude_base_interior_colorstring[]

Comma-separated normalized interior colors to exclude (Tan also matches Beige, Burgundy also matches Red), case-insensitive: Black, White, Silver, Gray, Red, Blue, Green, Yellow, Orange, Brown, Tan, Beige, Gold, Purple, Burgundy.

exclude_options_packagesstring[]

Comma-separated manufacturer option/package codes to exclude. Values: GET /v1/facets?facets=options_packages.

exclude_featuresstring[]

Comma-separated feature tokens to exclude. Values: GET /v1/facets?facets=features.

exclude_upfitterstring[]

Comma-separated upfitter ids to exclude: aev, airstream, ams_vans, armored, brabus, braunability, callaway, dinan, driverge, explorer_van, fox_factory, fr_conversions, freedom_motors, harley_davidson, hennessey, lingenfelter, mansory, midwest_automotive, ogv, overfinch, revability, rocky_ridge, rollx, roush, rtr, saleen, sca_black_widow, shelby_american, sherrod, singer, storyteller, tuscany, urban_automotive, vmi, waldoch, winnebago.

exclude_fuel_typestring[]

Comma-separated fuel types to exclude, case-insensitive: Gas only, Hybrid, Diesel, Full Electric, Plug-in Hybrid, Flex-fuel, Biodiesel, Fuel Cell Electric, Natural Gas (CNG), LPG, Other.

exclude_powertrain_typestring[]

Comma-separated powertrain types to exclude, case-insensitive: Combustion, HEV, MHEV, BEV, PHEV, FCEV, EREV.

exclude_keywordsstring[]

Comma-separated keyword tokens to exclude.

inventory_status'active' | 'sold'

Inventory mode. active is the default; sold searches historical sold inventory.

listed_afterstring date-time

Return listings first observed by Visor on or after this ISO 8601 timestamp, for example 2026-06-28T15:30:00Z.

sold_within_daysinteger

Positive integer day window for sold inventory, for example 30. Cannot be combined with snapshot_date.

snapshot_datestring date

Historical active-inventory snapshot date in YYYY-MM-DD format. Cannot be combined with sold inventory filters.

min_priceinteger

Minimum listed price in whole dollars.

max_priceinteger

Maximum listed price in whole dollars.

min_mileageinteger

Minimum odometer mileage.

max_mileageinteger

Maximum odometer mileage.

min_msrpinteger

Minimum combined MSRP in whole dollars.

max_msrpinteger

Maximum combined MSRP in whole dollars.

min_days_on_marketinteger

Minimum days on market.

max_days_on_marketinteger

Maximum days on market.

latitudenumber

Search origin latitude for sort=distance, distance_miles, and radius filtering.

longitudenumber

Search origin longitude for sort=distance, distance_miles, and radius filtering.

postal_codestring

US ZIP/postal search origin for sort=distance, distance_miles, and radius filtering.

radiusnumber

Maximum distance from the search origin, in miles. Requires postal_code or latitude and longitude. Maximum 500.

bboxnumber[]

Map viewport as west,south,east,north. Cannot be combined with radius. Maximum diagonal is 1000 miles.

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.