Connect key
GET/models/{brand_id}Dictionaries

Vehicle models

List or search models of a brand for the selected vehicle type.

  • Omit vehicle_type for automobiles; use motorcycle / 2 for motorcycles. Unknown or wrong-type brands return empty results.
  • Without pagination parameters, keeps the legacy array of up to 1,000 models. Send per_page=100 for {data, meta}.
  • Embedded generations retain {name, from, to}. Use /generations/{model_id} for IDs, production years, independent search and pagination.

Path parameters

1
brand_idinteger≥ 1Required

Positive brand ID from /brands for the same 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 · A bare array of Model objects, or {data, meta} with explicit pagination.
GET/models/{brand_id}
curl -g "https://api.auctionsapi.com/models/88?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ExamplesRecorded
[2 items
0: {3 keys
"id": 1968
"name": "Flying Spur"
"generations": [2 items]
}
1: {3 keys
"id": 2489
"name": "Bentayga"
"generations": [2 items]
}
]

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