Connect key
GET/generations/{model_id}Dictionaries

Vehicle generations

List or search active generations of an automobile or motorcycle model.

  • Use a model ID from /models/{brand_id}. Preserve vehicle_type: automobile / 1 is the default, motorcycle / 2 selects motorcycles.
  • query searches names, synonyms, ordinal and code. Production years are from_year / to_year; unknown or wrong-type models return an empty page.
  • per_page is 1–100, default 100. Follow next_page while page × per_page ≤ 10000, or next_after_id as after_id with page omitted. Stop when has_more is false.

Path parameters

1
model_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 · VehicleGeneration objects in data, with VehicleDictionaryMeta in meta.
GET/generations/{model_id}
curl -g "https://api.auctionsapi.com/generations/201?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ExamplesExample
{2 keys
"data": [1 item
0: {9 keys
"id": 301
"name": "Example generation"
"brand_id": 101
"model_id": 201
"vehicle_type": 1
"from_year": 2020
"to_year": null
"ordinal": null
"code": "EX1"
}
]
"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