GET /v1/vehicles/manufacturers

Makes and the three-character manufacturer identifiers (WMIs) their VINs start with. The first three characters of a VIN identify the manufacturer. A make usually has several identifiers, for different manufacturers, countries or vehicle types.

Use it to show which identifiers a make uses, or to find the make for the first three characters of a VIN. A Vehicle field sets the identifier of each VIN it generates, so a request does not use these values.

Request

Query parameter	Required	Default	Description
vehicleType	No	none	Lists only identifiers assigned to this vehicle type. Repeat it to allow several types. See VehicleType. Omit for every type.

curl "https://api.alchemy.example/v1/vehicles/manufacturers?vehicleType=PassengerCar&vehicleType=MultipurposePassengerVehicle" \
  -H "X-Api-Key: YOUR_API_KEY"

Response

An array of { make, countries, vehicleTypes, wmis }, alphabetical by make. wmis are the identifiers the make's VINs start with, countries are the countries those identifiers are assigned to, and vehicleTypes are the vehicle types those identifiers are assigned to. With vehicleType set, each list contains only the values for the requested types, and a make with none of them is not included.

[
  {
    "make": "Acura",
    "countries": ["Canada", "United States"],
    "vehicleTypes": ["PassengerCar"],
    "wmis": ["19U", "JH4"]
  },
  {
    "make": "Alfa Romeo",
    "countries": ["Italy"],
    "vehicleTypes": ["PassengerCar"],
    "wmis": ["ZAR"]
  }
]

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

countries is empty for a make whose identifiers have no country.

VehicleType

Value	Vehicle type
Bus	A bus.
IncompleteVehicle	An incomplete vehicle, such as a chassis cab finished by another manufacturer.
LowSpeedVehicle	A low speed vehicle, such as a neighborhood electric vehicle or a golf cart.
Motorcycle	A motorcycle.
MultipurposePassengerVehicle	A multipurpose passenger vehicle, including sport utility vehicles and minivans.
OffRoadVehicle	An off-road vehicle.
PassengerCar	A passenger car.
Trailer	A trailer.
Truck	A truck, including pickups and heavy trucks.

Errors

400 with a ProblemDetails body for a vehicleType that is not one of the values above:

{
  "type": "urn:alchemy:error:invalid-reference-query",
  "title": "Invalid request.",
  "status": 400,
  "detail": "vehicleType 'Plane' is not a vehicle type. Use one of: PassengerCar, MultipurposePassengerVehicle, Truck, Bus, Motorcycle, LowSpeedVehicle, OffRoadVehicle, Trailer, IncompleteVehicle."
}

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