---
title: "Get a supported market vehicle taxonomy and native units"
method: GET
path: "/v1/taxonomies"
tags: ["Discovery"]
---

# Get a supported market vehicle taxonomy and native units

`GET /v1/taxonomies`

## Request

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

## Query parameters

- `country` 'US' | 'CA'

## Response `200`

Versioned taxonomy values

- TaxonomyResponse
  - `release` 'us-v1' | 'ca-v1', required
  - `country` 'US' | 'CA', required
  - `units` object, required
    - `currency` 'USD' | 'CAD', required
    - `distance` 'miles' | 'kilometres', required
    - `odometer` 'miles' | 'kilometres', required
  - `condition` string[], required
  - `vehicle_type` string[], required
  - `status` string[], required
  - `fuel` string[], required
  - `driveline` string[], required
  - `body` string[], required
  - `sort` SortBy[], 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)