---
title: "Get one search facet"
method: GET
path: "/v1/facets"
tags: ["Discovery"]
---

# Get one search facet

`GET /v1/facets`

## Request

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

## Query parameters

- `s` string
- `dimension` 'vehicle_type' | 'make' | 'model' | 'trim' | 'condition' | 'body' | 'fuel' | 'exterior_color' | 'interior_color' | 'year' | 'charge_port' | 'dc_fast_charge', required
- `q` string
- `country` 'US' | 'CA'
- `region_code` string
- `zip` string
- `latitude` number
- `longitude` number
- `radius_miles` union
  - number
  - 'any'
- `make` string[]
- `model` string[]
- `condition` string[]
- `year_min` integer
- `year_max` integer
- `north` number
- `south` number
- `east` number
- `west` number
- `limit` integer

## Response `200`

Facet buckets

- FacetBucket[]
  - `id` string
  - `label` string
  - `selected` boolean
  - `model_scope` 'family'
  - `value` union, required
    - string
    - number
    - boolean
  - `count` integer, required

---

[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)