GET /v1/vehicles/models

Models a Vehicle field accepts, with the model years of each. These are the values the field's models filter accepts.

Request

Query parameter	Required	Default	Description
make	No	none	Lists only the models of this make, matched without regard to case. See GET /v1/vehicles/makes. Omit to list the models of every make.

curl "https://api.alchemy.example/v1/vehicles/models?make=honda" -H "X-Api-Key: YOUR_API_KEY"

Response

An array of { make, model, firstYear, lastYear, vehicles }, ordered by make and then by model. model is the value models accepts, firstYear and lastYear are the earliest and latest model years of the model, and vehicles is the number of vehicle configurations of the model.

[
  { "make": "Honda", "model": "Accord", "firstYear": 1990, "lastYear": 2025, "vehicles": 200 },
  { "make": "Honda", "model": "Civic", "firstYear": 1990, "lastYear": 2025, "vehicles": 300 }
]

The entries above are an example. Call the endpoint for the current list and values.

More than one make can use the same model name. Name the make in the models entry to select only that make's model:

{
  "type": "Vehicle",
  "models": [
    { "make": "Honda", "model": "Accord" },
    { "make": "Honda", "model": "Civic" }
  ],
  "map": { "modelVariant": { "column": "variant", "dataType": "VarChar" } }
}

Errors

400 with a ProblemDetails body for a make that has no vehicles:

{
  "type": "urn:alchemy:error:invalid-reference-query",
  "title": "Invalid request.",
  "status": 400,
  "detail": "No make named 'nope' has vehicles. See GET /v1/vehicles/makes for the makes that do."
}

Requires an API key (see Authentication) but is not billed.