variants

Filter variants

Structured filtering. Paginated with a keyset cursor, not an offset: links.next carries an opaque c_… token to hand back as ?cursor=. Page size is capped at 50.

Not part of the demo tier.

get/variants

Request

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

Query parameters

locale'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'fr' | 'hr' | 'hu' | 'it' | 'no' | 'pl' | 'pt' | 'ro' | 'sk' | 'sr' | 'sv' | 'tr'

One of the 20 published languages. Anything else — including a language the site does not publish — falls back to en silently.

cursorstring
Example:c_0a1b2c3d

Opaque pagination token — hand back the links.next value from the previous page. Omit it for the first page. A token that cannot be read restarts from the first page rather than failing, so a client holding a stale cursor pages again instead of breaking.

limitinteger

Page size, 1–50. Values above 50 are clamped to 50.

fuelstring

Fuel slug, e.g. benzine, elektrisch.

bodystring

Body type, matched against the English body-type label.

drivestring

Drivetrain.

power_mininteger

Minimum power, hp.

power_maxinteger

Maximum power, hp.

price_maxinteger

Maximum new list price, EUR.

yearinteger

Production year covered by the generation.

evboolean

Pass true for battery-electric variants only. Any other value is ignored.

Headers

PAYMENT-SIGNATUREstring

x402 v2 payment proof, base64 JSON, built by an x402 client from the PAYMENT-REQUIRED header of a previous 402. Only on the two paid routes, and only without a key — a request with a key ignores it.

Response

OK. Paid with x402, it also carries PAYMENT-RESPONSE.

Example response

{
  "data": [
    {
      "generation_id": "g_1a2b3c4d",
      "variant_id": "v_1a2b3c4d"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.