Connect key
GET/trims/{generation_id}Dictionaries

Vehicle trims

List or search active equipment grades 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 searches names and synonyms. per_page is 1–100, default 100. Use page or after_id, never both; follow next_after_id for traversal beyond 10,000 results.
  • Unknown or wrong-type generations return an empty page. A trim and variant sharing a generation are not automatically compatible.

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/trims/{generation_id}
curl -g "https://api.auctionsapi.com/trims/301?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ExamplesExample
{2 keys
"data": [1 item
0: {6 keys
"id": 401
"name": "Example trim"
"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