Table of Contents

GET /v1/vehicles/makes

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

Request

No body, no query parameters.

curl https://api.alchemy.example/v1/vehicles/makes \
  -H "X-Api-Key: YOUR_API_KEY"

Response

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

[
  { "make": "Acura", "firstYear": 1990, "lastYear": 2025, "models": 12, "vehicles": 300 },
  { "make": "Honda", "firstYear": 1990, "lastYear": 2025, "models": 15, "vehicles": 800 }
]

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

Each makes entry contains one make, matched without regard to case, so Honda and honda select the same make:

{
  "type": "Vehicle",
  "makes": [
    { "make": "Honda", "weight": 2 },
    { "make": "acura" }
  ],
  "map": { "model": { "column": "model", "dataType": "VarChar" } }
}

To list the models of a make, see GET /v1/vehicles/models.

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