---
title: "Search inventory-backed sales locations or explicitly declared service/parts locations"
method: GET
path: "/v1/dealers"
tags: ["Dealers"]
---

# Search inventory-backed sales locations or explicitly declared service/parts locations

`GET /v1/dealers`

## Request

- Base URL: `https://api.carhandshake.com`
- URL: `https://api.carhandshake.com/v1/dealers`
- Auth: none required

## Query parameters

- `department` 'sales' | 'service' | 'parts'
- `q` string
- `country` 'US' | 'CA'
- `region_code` string
- `place_name` string
- `postal_code` string
- `limit` integer
- `offset` integer

## Response `200`

Dealerships

- DealerDetail[]
  - `id` string, uuid, required
  - `name` string, required
  - `domain` string, required
  - `agent_card_url` string, uri
  - `a2a_url` string, uri
  - `locations` PublicLocation[], required
    - `id` string, uuid, required
    - `name` string, required
    - `address_line_1` string, nullable, required
    - `address_line_2` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `zip` string, nullable, required
    - `country` 'US' | 'CA', required
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
    - `geo_source` string, nullable, required
    - `geocode_precision` string, nullable, required
    - `geocode_confidence` number, nullable, required
    - `timezone` string, nullable, required
    - `website_url` string, uri, nullable, required
    - `public_phone` PublicPhone, required
      - `name` string, nullable, required
      - `value` string, required
    - `hours` BusinessHoursSchedule[], required
      - `name` string, required
      - `monday` BusinessHoursInterval
        - `open` string, required
        - `close` string, required
      - `tuesday` BusinessHoursInterval
        - `open` string, required
        - `close` string, required
      - `wednesday` BusinessHoursInterval
        - `open` string, required
        - `close` string, required
      - `thursday` BusinessHoursInterval
        - `open` string, required
        - `close` string, required
      - `friday` BusinessHoursInterval
        - `open` string, required
        - `close` string, required
      - `saturday` BusinessHoursInterval
        - `open` string, required
        - `close` string, required
      - `sunday` BusinessHoursInterval
        - `open` string, required
        - `close` string, required
    - `capabilities` string[], required
  - `vehicle_count` integer, required

## Other responses

- `400`: RFC 9457 problem details

---

[API](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api.md) · [All operations](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api/revisions/0a85bfd1c565?raw)