> ## Documentation Index
> Fetch the complete documentation index at: https://api.visor.vin/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a dealer

> Returns one dealer summary by dealer_id. Missing dealers return 404 not_found_error.



## OpenAPI

````yaml /openapi.json get /v1/dealers/{dealer_id}
openapi: 3.1.0
info:
  title: Visor Public API
  version: 1.0.0-beta
  summary: Vehicle listings, facets, VIN, and dealer data for API customers.
  description: >-
    Public beta API for customer integrations. Normal /v1 endpoints require
    Authorization: Bearer <api_key>. API keys are scoped to API accounts; usage
    is metered per request and billed from the account ledger. The OpenAPI
    document is available without authentication at /v1/openapi.json.
servers:
  - url: https://api.visor.vin
    description: Production public API
security:
  - bearerAuth: []
tags:
  - name: Inventory
  - name: Dealers
  - name: Usage
paths:
  /v1/dealers/{dealer_id}:
    get:
      tags:
        - Dealers
      summary: Get a dealer
      description: >-
        Returns one dealer summary by dealer_id. Missing dealers return 404
        not_found_error.
      operationId: publicDealers.dealer
      parameters:
        - name: dealer_id
          in: path
          schema:
            type: string
            description: Dealer UUID.
          required: true
          description: Dealer UUID.
          example: b62c6042-b3a0-4a58-bc5b-55966bd1c68c
      responses:
        '200':
          description: Successful public API response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      dealer_id:
                        type: string
                        description: Dealer UUID.
                      name:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Dealer display name.
                      city:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Dealer city.
                      state:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Dealer state.
                      country:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Dealer country code.
                      latitude:
                        anyOf:
                          - type: number
                          - type: 'null'
                        description: Dealer latitude when available.
                      longitude:
                        anyOf:
                          - type: number
                          - type: 'null'
                        description: Dealer longitude when available.
                      type:
                        anyOf:
                          - type: string
                            enum:
                              - franchise
                              - independent
                          - type: 'null'
                        description: Dealer type.
                      website:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Dealer website as an absolute URL when available.
                      makes:
                        type: array
                        items:
                          type: string
                        description: >-
                          Represented franchise makes. Empty when unavailable or
                          not applicable.
                      listing_count:
                        type: number
                        description: Current active listing count for the dealer.
                      phone:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Dealer phone number when available.
                      address:
                        anyOf:
                          - type: object
                            properties:
                              line1:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                                description: Dealer street address line when available.
                              city:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                                description: Dealer city.
                              state:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                                description: Dealer state.
                              postal_code:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                                description: Dealer ZIP or postal code.
                              country:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                                description: Dealer country code.
                            required:
                              - line1
                              - city
                              - state
                              - postal_code
                              - country
                            additionalProperties: false
                            description: Structured dealer address.
                          - type: 'null'
                        description: Dealer address when available.
                    required:
                      - dealer_id
                      - name
                      - city
                      - state
                      - country
                      - latitude
                      - longitude
                      - type
                      - website
                      - makes
                      - listing_count
                      - phone
                      - address
                    additionalProperties: false
                    description: Dealer record.
                  meta:
                    type: object
                    description: >-
                      Reserved metadata object. It is empty for the beta
                      contract unless an endpoint documents otherwise.
                required:
                  - data
                  - meta
                additionalProperties: false
                description: Dealer detail response envelope.
              examples:
                success:
                  summary: Dealer profile with address
                  value:
                    data:
                      dealer_id: b62c6042-b3a0-4a58-bc5b-55966bd1c68c
                      name: Claremont Toyota
                      city: Claremont
                      state: CA
                      postal_code: '91711'
                      country: US
                      latitude: 34.080929
                      longitude: -117.72527
                      type: franchise
                      website: https://claremonttoyota.com
                      makes:
                        - Toyota
                      listing_count: 1656
                      phone: (909) 455-9142
                      address:
                        line1: 601 Auto Center Dr
                        city: Claremont
                        state: CA
                        postal_code: '91711'
                        country: US
                    meta: {}
          headers:
            X-Usage-Class:
              description: >-
                Metering class used for the request, for example listing_search,
                listing_search_enriched, facet_counts_historical,
                vehicle_detail_enriched, or dealer_lookup.
              schema:
                type: string
            X-Usage-Cost-Micros:
              description: >-
                Usage cost for this request in integer USD micros. 1000000
                micros equals 1 USD.
              schema:
                type: string
            X-Pricing-Version:
              description: Pricing catalog version UUID used to calculate the request cost.
              schema:
                type: string
            X-RateLimit-Tier:
              description: Effective account Usage Tier code used for rate limiting.
              schema:
                type: string
            X-RateLimit-Limit-10s:
              description: Maximum requests allowed in the 10-second burst window.
              schema:
                type: string
            X-RateLimit-Remaining-10s:
              description: >-
                Remaining requests in the current 10-second burst window after
                this request.
              schema:
                type: string
            X-RateLimit-Limit-60s:
              description: Maximum requests allowed in the 60-second sustained window.
              schema:
                type: string
            X-RateLimit-Remaining-60s:
              description: >-
                Remaining requests in the current 60-second sustained window
                after this request.
              schema:
                type: string
        '400':
          description: >-
            Invalid path or query parameter. Unknown query parameters are
            rejected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiValidationError'
        '401':
          description: Missing, malformed, or invalid Authorization bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiAuthenticationError'
        '402':
          description: The API account is blocked by billing state or prepaid balance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiBillingError'
        '403':
          description: The API key is valid but does not include the required scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiPermissionError'
        '404':
          description: The requested VIN or dealer detail resource was not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiNotFoundError'
        '429':
          description: >-
            The API account exceeded the public API rate limit. Retry-After is
            included when available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiRateLimitError'
        '503':
          description: >-
            The platform could not price, meter, rate-limit, or fetch data for
            the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiPlatformError'
      security:
        - bearerAuth: []
components:
  schemas:
    PublicApiValidationError:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - PublicApiValidationError
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            current_version:
              anyOf:
                - type: string
                - type: 'null'
            minimum_supported_version:
              anyOf:
                - type: string
                - type: 'null'
            reason_code:
              anyOf:
                - type: string
                - type: 'null'
            update_url:
              type: string
            update_command:
              type: string
          required:
            - type
            - code
            - message
          additionalProperties: false
      required:
        - _tag
        - error
      additionalProperties: false
    PublicApiAuthenticationError:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - PublicApiAuthenticationError
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            current_version:
              anyOf:
                - type: string
                - type: 'null'
            minimum_supported_version:
              anyOf:
                - type: string
                - type: 'null'
            reason_code:
              anyOf:
                - type: string
                - type: 'null'
            update_url:
              type: string
            update_command:
              type: string
          required:
            - type
            - code
            - message
          additionalProperties: false
      required:
        - _tag
        - error
      additionalProperties: false
    PublicApiBillingError:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - PublicApiBillingError
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            current_version:
              anyOf:
                - type: string
                - type: 'null'
            minimum_supported_version:
              anyOf:
                - type: string
                - type: 'null'
            reason_code:
              anyOf:
                - type: string
                - type: 'null'
            update_url:
              type: string
            update_command:
              type: string
          required:
            - type
            - code
            - message
          additionalProperties: false
      required:
        - _tag
        - error
      additionalProperties: false
    PublicApiPermissionError:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - PublicApiPermissionError
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            current_version:
              anyOf:
                - type: string
                - type: 'null'
            minimum_supported_version:
              anyOf:
                - type: string
                - type: 'null'
            reason_code:
              anyOf:
                - type: string
                - type: 'null'
            update_url:
              type: string
            update_command:
              type: string
          required:
            - type
            - code
            - message
          additionalProperties: false
      required:
        - _tag
        - error
      additionalProperties: false
    PublicApiNotFoundError:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - PublicApiNotFoundError
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            current_version:
              anyOf:
                - type: string
                - type: 'null'
            minimum_supported_version:
              anyOf:
                - type: string
                - type: 'null'
            reason_code:
              anyOf:
                - type: string
                - type: 'null'
            update_url:
              type: string
            update_command:
              type: string
          required:
            - type
            - code
            - message
          additionalProperties: false
      required:
        - _tag
        - error
      additionalProperties: false
    PublicApiRateLimitError:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - PublicApiRateLimitError
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            current_version:
              anyOf:
                - type: string
                - type: 'null'
            minimum_supported_version:
              anyOf:
                - type: string
                - type: 'null'
            reason_code:
              anyOf:
                - type: string
                - type: 'null'
            update_url:
              type: string
            update_command:
              type: string
          required:
            - type
            - code
            - message
          additionalProperties: false
        retryAfter:
          type: number
      required:
        - _tag
        - error
      additionalProperties: false
    PublicApiPlatformError:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - PublicApiPlatformError
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            current_version:
              anyOf:
                - type: string
                - type: 'null'
            minimum_supported_version:
              anyOf:
                - type: string
                - type: 'null'
            reason_code:
              anyOf:
                - type: string
                - type: 'null'
            update_url:
              type: string
            update_command:
              type: string
          required:
            - type
            - code
            - message
          additionalProperties: false
      required:
        - _tag
        - error
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send API keys as Authorization: Bearer <api_key>. Query-string API keys
        are rejected.

````