Connect key
GET/variants/{generation_id}Dictionaries

Vehicle variants

List or search active factory variants for a vehicle generation.

  • Use a generation ID from /generations/{model_id} and preserve vehicle_type. Automobiles are the default; motorcycle / 2 selects motorcycles.
  • query matches names and saved variant aliases by case-insensitive literal substring. per_page is 1–100, default 100; use page or after_id, never both.
  • Returns the current published configuration only. A generation without a publication returns an empty page; an unavailable or stale publication returns 503. Responses contain identities, without factory facts or compatibility pairs.

Path parameters

1
generation_idinteger≥ 1Required

Positive parent ID from the preceding dictionary; preserve vehicle_type.

Query parameters

6
vehicle_typestringdefault automobile

vehicle_type=automobile / 1 is the default; motorcycle / 2 selects motorcycles on /search, /search/count and /cars. Use the same type for dictionaries.

querystring≤ 200 chars

Optional literal name or synonym search, up to 200 characters. Blank disables search; * and ? are literal text.

pageinteger1–10,000 · default 1

per_page is 1–100, default 100. Use page or after_id, never both. Offset: page × per_page ≤ 10000. For complete traversal, send next_after_id as after_id with page omitted until has_more=false. total then counts remaining matches.

per_pageinteger1–100 · default 100

per_page is 1–100, default 100. Use page or after_id, never both. Offset: page × per_page ≤ 10000. For complete traversal, send next_after_id as after_id with page omitted until has_more=false. total then counts remaining matches.

after_idinteger≥ 1

per_page is 1–100, default 100. Use page or after_id, never both. Offset: page × per_page ≤ 10000. For complete traversal, send next_after_id as after_id with page omitted until has_more=false. total then counts remaining matches.

langstring

Response locale. Option translations are also limited by the account languages. The page selects its current language automatically.

Returns · VehicleConfigurationEntry objects in data, with VehicleDictionaryMeta in meta.
GET/variants/{generation_id}
curl -g "https://api.auctionsapi.com/variants/301?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ExamplesExample
{2 keys
"data": [1 item
0: {6 keys
"id": 501
"name": "Example variant"
"brand_id": 101
"model_id": 201
"generation_id": 301
"vehicle_type": 1
}
]
"meta": {8 keys}
}

Get API access

Connect your key to run every request on these pages against your own data. No key yet? Ask us for a demo key: the same JSON as the paid plans.

I have a key