---
title: "One variant, with its full language-neutral spec document"
method: GET
path: "/variants/{id}"
tags: ["variants"]
---

# One variant, with its full language-neutral spec document

`GET /variants/{id}`

## Request

- Base URL: `https://api.cars-data.com/v1`
- URL: `https://api.cars-data.com/v1/variants/{id}`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP bearer

Returns the summary fields plus `spec_count` and `specs` — the raw,
language-neutral spec document. For localized labels and units use
`/variants/{id}/specs`.

In the demo tier the same path answers from the blob and returns the
summary fields only (no `specs`); a car outside the 40 gets `403`.

## Path parameters

- `id` string, required

## Response `200`

OK

- VariantDetailEnvelope
  - `data` VariantDetail: The summary projection used by every list endpoint.
    - `accel_0_100_s` number, nullable
    - `battery_kwh` number, nullable
    - `body_type_en` string, nullable
    - `display_name` string
    - `fuel_slug` string, nullable
    - `generation_id` string
    - `power_hp` integer, nullable
    - `price_new_eur` integer, nullable
    - `top_speed_kmh` integer, nullable
    - `torque_nm` integer, nullable
    - `variant_id` string
    - `spec_count` integer: How many spec values this variant has. `0` for the handful with none.
    - `specs` object: The raw, language-neutral spec document. `{}` when the variant has no spec rows. Use `/variants/{id}/specs` for localized labels.
  - `meta` Meta
    - `last_synced_at` string, date-time, required
    - `locale` string
    - `units` 'metric' | 'imperial'

## Other responses

- `401`: No key, or a key we do not know. `WWW-Authenticate: Bearer` on the MCP surface. The MCP server needs no key at all; a REST demo key is one click away. On the two x402 routes a request with no key gets `402` instead, with the price.
- `403`: RFC 9457 problem document.
- `404`: Not found. A token that does not decode gets this too.

---

[API](https://skmtc.dev/cars-data/apis/cars-data-com-api.md) · [All operations](https://skmtc.dev/cars-data/apis/cars-data-com-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cars-data/apis/cars-data-com-api/revisions/4aeb6b2b5c5f?raw)