Changelog

​

Changed

• options arrays on /v1/vins/{vin}, /v1/listings/{listing_id}, and listing collections requested with include=options now deduplicate entries that share a display name, keeping the entry that carries an MSRP when available.
• VIN and listing detail responses temporarily omit interior or exterior color options when a vehicle’s catalog data contains more than one conflicting color of the same type; suppression will be retired once the upstream data remediation completes.

​

Compatibility

​

Added

• /v1/listings, dealer listing collections, and /v1/facets now support model_code as a listing filter.
• /v1/facets now supports facets=model_code to discover manufacturer model-code buckets within a listing cohort.

​

Compatibility

​

Added

• MCP execute now accepts either an async arrow function or a plain JavaScript statement body with await and return.
• Async arrow functions with trailing semicolons are accepted, matching common generated code.

​

Compatibility

​

Added

• /v1/listings and dealer listing collections now support postal_code and listed_at in fields.
• /v1/listings, /v1/dealers/{dealer_id}/listings, and /v1/facets now support listed_after=<ISO timestamp> to filter listings first observed by Visor on or after that time.
• Listing collections now support sort=listed_at and sort=-listed_at.

​

Compatibility

​

Added

• /v1/listings and dealer listing collections now support availability_status in fields, returning stock, transit, build, or null when requested.
• MCP listing guidance now presents availability_status as both filterable and selectable, matching common agent usage.

​

Compatibility

​

Changed

• Updated the Claude MCP setup guide to use Customize → Connectors for individual connector setup and member authentication. Team and Enterprise owners still add organization connectors from organization connector settings.

​

Compatibility

​

Fixed

• /v1/listings?dealer_id=... now validates dealer IDs before searching, so malformed values return 400 validation_error instead of 503 platform_error.

​

Added

• /v1/facets now supports powertrain_type as a categorical facet for discovering available powertrain buckets within a listing cohort.

​

Compatibility

​

Added

• Added nullable pricing detail to /v1/vins/{vin} under data.latest_listing.pricing and to /v1/listings/{listing_id} under data.pricing when supported provider pricing details are available.
• The existing price field is unchanged. pricing.line_items includes customer-facing amount, label, role, applicability, direction, row key/order, and subtype fields only.

​

Compatibility

​

Fixed

• Fixed /v1/listings/{listing_id} for sold listing IDs returned from listing collections so eligible sold listings resolve consistently instead of returning a platform error or missing detail response.

​

Compatibility

​

Changed

• Clarified VIN lookup docs: unknown VINs return 404 not_found_error, while known VINs can return status: "missing" when they no longer appear in active inventory but have not been classified as sold.

​

Compatibility

​

Changed

• Starter API Credit follows your Visor plan: Free $1, Plus weekly$1, Plus monthly $10, Plus annual$50, Plus lifetime $100. The first$1 is a baseline that never expires.
• The amount above the $1 baseline is a one-time paid-plan starter boost. Unused boost credit expires 12 months after it is granted — one rule for every plan. Credit you have already spent is never clawed back, and purchased API Credit never expires.
• The 12-month expiry also applies to starter credit granted before this change, measured from the original grant date.

​

Compatibility

​

Added

• Added How the Data Works, covering listings, VINs, dealers, inventory modes, deduplication, sold inventory, advertised pricing semantics, null handling, and recommended workflows.
• Added Glossary, defining public fields, filters, response concepts, usage terms, and vehicle-market vocabulary.
• Clarified that sold inventory requires at least three days missing from the dealer inventory feed, discount_from_msrp uses combined MSRP, and price is the dealer’s main advertised listing price.

​

Compatibility

​

Added

• Added dedicated guides for authentication and scopes, filter and facet discovery, API errors and retries, and common copyable workflows.
• Added embedded request and successful response examples to each generated Public API reference operation.
• Reorganized the Guides navigation into Start, Core concepts, Workflows, and Updates sections.

​

Compatibility

​

Changed

• MCP search results and public docs now call out the facet response envelope: categorical buckets are under data.facets.<name>, numeric buckets under data.range_facets.<name>, and stats under data.stats.<name>.
• inventory_type, exclude_inventory_type, keywords, exclude_keywords, and listing dealer_type filters now validate their supported tokens. inventory_type=cpo is accepted as an alias for certified.
• Listing and facet filters now support powertrain_type, exclude_inventory_type, exclude_body_type, exclude_transmission, and exclude_drivetrain.
• Invalid VIN characters and malformed dealer IDs now return targeted validation_error responses instead of being conflated with missing resources or transient data errors.

​

Compatibility

​

Added

• /v1/dealers?dealer_id=id1,id2 now returns matching dealer profiles for up to 100 comma-separated dealer IDs.

​

Changed

• Public dealer, listing, facet, VIN, and listing-detail responses now consistently omit dealer sources that are not eligible for Public API exposure.
• MCP operation search now surfaces the dealer ID lookup filter for dealer profile batches.
• Deprecated /v1/listings/search compatibility requests continue to execute and return migration headers. per_page maps to limit, and one-based page maps to offset.

​

Compatibility

​

Changed

• MCP visor.usage.summary() now accepts an omitted query object.
• Listing fields validation errors now clarify that fields controls response projection and list the supported listing fields.
• MCP listing guidance now calls out response.data for rows and response.pagination.total for collection totals.

​

Compatibility

​

Changed

• MCP visor.vins.get(vin) and visor.listings.get(listingId) now accept omitted options objects.
• MCP search results and generated listing field docs now more clearly distinguish response fields from filters such as availability_status, options_packages, and features.

​

Compatibility

​

Changed

• New self-serve Public API accounts receive one-time starter API Credit based on subscription plan: Free $1, Plus weekly $5, Plus monthly $10, Plus annual $50, and Plus lifetime $100.

​

Compatibility

​

Changed

• The MCP setup guide has clearer app-specific connection steps, OAuth and bearer-token guidance, and examples for chat apps, coding agents, generic MCP clients, and API-based MCP usage.

​

Compatibility

​

Added

• include=price_history responses now include miles on each price change event when odometer data is available.

​

Compatibility

​

Changed

• /v1/listings and dealer listing collections now allow fields=dealer_type to return the listing dealer type.
• MCP search results now include parameter descriptions and response notes, including where collection totals are returned.

​

Compatibility

​

Added

• New self-serve Public API accounts receive $1.00 in promotional API Credit.

​

Compatibility

​

Changed

• /v1/dealers?make=... now matches represented Dealer Makes with the same display-name and slug handling used by Listing filters.

​

Compatibility

​

Changed

• Make/model filters now match vehicle names with punctuation, symbols, or accents more consistently across public inventory queries.

​

Compatibility

​

Changed

• MCP facet metric types and generated OpenAPI descriptions now include discount_from_msrp, matching the existing /v1/facets contract.

​

Compatibility

​

Changed

• Increased the MCP execute workflow ceiling from 10 to 50 underlying public API requests.
• Added MCP-side pacing, bounded 429 retries, and retry_after_seconds guidance when the client needs to wait.

​

Compatibility

​

Changed

• /v1/listings and /v1/facets now use availability_status values: stock, transit, and build.
• Removed public in_transit filtering. Use availability_status=stock instead of in_transit=false, and availability_status=transit,build instead of in_transit=true.

​

Compatibility

​

Added

• Released the hosted MCP server at https://mcp.visor.vin/mcp with OAuth and bearer-token authentication.
• Added search and execute tools for agent access to the Visor Public API.

​

Compatibility