# Visor Public API

## Docs

- [Get a dealer](https://api.visor.vin/docs/api-reference/dealers/get-a-dealer.md): Returns one dealer summary by dealer_id. Missing dealers return 404 not_found_error.
- [List a dealer's inventory](https://api.visor.vin/docs/api-reference/dealers/list-a-dealers-inventory.md): Returns listing summaries scoped to one dealer after VIN-level listing deduplication and ownership assignment. If a dealer feed contains a VIN that Freeway attributes to another dealer, that VIN may not appear here. Supports the listing filter and pagination surface.
- [Search dealers](https://api.visor.vin/docs/api-reference/dealers/search-dealers.md): Returns public dealer summaries ordered by active listing count. Listing counts use VIN-level listing deduplication and ownership assignment, so they can differ from raw dealer feed counts. Use dealer_id, state, country, type, make, and q to narrow results.
- [Filter facets](https://api.visor.vin/docs/api-reference/inventory/filter-facets.md): Returns categorical facets, numeric range facets, and stats for an explicit listing filter surface facet selection. Use facets=make,model,price. Supported facets: make, model, inventory_type, year, trim, version, base_exterior_color, exterior_color, base_interior_color, interior_color, seating_capac…
- [Filter listings](https://api.visor.vin/docs/api-reference/inventory/filter-listings.md): Returns active, sold, or historical snapshot listing summaries using stable snake_case fields. Public inventory is deduplicated by VIN and assigned to the dealer Freeway believes owns the listing, so dealer-scoped counts can differ from raw dealer feed counts. Unknown query parameters fail closed wi…
- [Get a listing](https://api.visor.vin/docs/api-reference/inventory/get-a-listing.md): Returns listing-centered detail by listing_id. Missing listings return 404 not_found_error.
- [Look up a VIN](https://api.visor.vin/docs/api-reference/inventory/look-up-a-vin.md): Returns the current or latest known record for a VIN. Missing VINs return 404 not_found_error.
- [Summarize usage](https://api.visor.vin/docs/api-reference/usage/summarize-usage.md): Returns daily billable usage totals for the authenticated API account. Usage analytics are eventually consistent with the billing ledger and are intended for customer dashboards and reconciliation.
- [Authentication](https://api.visor.vin/docs/authentication.md): Create API credentials, send bearer tokens safely, and choose the right scopes.
- [Changelog](https://api.visor.vin/docs/changelog.md): Customer-visible updates to the Visor Public API, MCP server, and developer docs.
- [Prompt an AI Agent](https://api.visor.vin/docs/cli/agent-usage.md): Copy a prompt that tells an AI agent how to install and use the Visor CLI safely.
- [Visor CLI](https://api.visor.vin/docs/cli/guide.md): Install, authenticate, update, and use the Visor CLI for the Public API.
- [How the Data Works](https://api.visor.vin/docs/data-works.md): Understand what Visor listing, VIN, dealer, facet, and usage data means in day-to-day API work.
- [Errors and Retries](https://api.visor.vin/docs/errors-and-retries.md): Understand Visor API error envelopes, status codes, rate limits, and retry behavior.
- [Common Examples](https://api.visor.vin/docs/examples.md): Copyable Public API workflows for vehicle searches, facets, dealer inventory, and usage.
- [Filters and Facets](https://api.visor.vin/docs/filters-and-facets.md): Use facets to discover valid vehicle values, then build reliable listing and dealer queries.
- [Glossary](https://api.visor.vin/docs/glossary.md): Definitions for the public API terms, fields, filters, and response concepts you will see most often.
- [Visor Public API](https://api.visor.vin/docs/index.md): Vehicle inventory, facets, VIN lookup, and dealer data for customer integrations.
- [Connect to your AI agent](https://api.visor.vin/docs/mcp-setup.md): Add the Visor MCP server to Claude, ChatGPT, Codex, or any AI agent. Most apps connect in under a minute.
- [Quickstart](https://api.visor.vin/docs/quickstart.md): Make your first authenticated requests to the Visor Public API.
- [Usage Tiers](https://api.visor.vin/docs/usage-tiers.md): Understand public API rate limits, tier movement, and account-specific limits.

## OpenAPI Specs

- [openapi](https://api.visor.vin/docs/openapi.json)