Image
One image per model
GET/api/{brand}/{model}/image
A representative image of a model without knowing year, body style or trim — e.g. for a model picker. /api/{brand}/{model}/modelimage is the same endpoint.
The car is chosen by a fixed rule, so the same model always returns the same car: the newest year, the most common body style of that year, the base trim (otherwise the first), and the front_left view (otherwise the first exterior view your plan allows). Narrow it down with year, variant or view.
The response is exactly the single-view image response of the chosen car — id, year, variant and trim tell you which one, so you can continue with the catalog or /api/id/{id}. All image options (format, width, color, …) apply, and it counts like any single image.
Path parameters
| Name | Type | Description |
|---|---|---|
brand required | string | Brand name — see /api/brands. |
model required | string | Model name — see /api/{brand}. |
Query parameters
| Name | Type | Description |
|---|---|---|
year | integer | Use the generation of this year instead of the newest (same rule as the catalog). |
variant | string | Only this body style (equivalent names like `Kombi` / `Estate` work as in the catalog). |
view | string | Another view than `front_left` — see /api/views. |
version | string | Results from one version only: `v1` = standard images, `v2` = API v2 add-on (no fallback to standard images). Without it: everything your key allows. Not allowed for your key → `403`. v1v2 |
