Copy page

Documentation

Makes

A make is a car brand, such as Toyota or BMW.

List makes

Code
GET /api/makes

Returns every make, sorted by name, with the number of models and trims.

Example

Code
curl http://localhost:3000/api/makes

Code
{
  "data": [
    {
      "id": 1,
      "name": "Acura",
      "model_count": 6,
      "trim_count": 80,
      "first_year": 2022,
      "last_year": 2024
    },
    {
      "id": 2,
      "name": "Alfa Romeo",
      "model_count": 3,
      "trim_count": 50,
      "first_year": 2022,
      "last_year": 2024
    }
  ],
  "count": 46
}

Fields

Field	Type	Description
id	integer	Make ID
name	string	Make name
model_count	integer	Number of models
trim_count	integer	Number of trims
first_year	integer	Earliest model year
last_year	integer	Latest model year

Get a make

Code
GET /api/makes/{makeId}

Path parameters

Name	Type	Description
makeId	integer	Make ID

Example

Code
curl http://localhost:3000/api/makes/1

Code
{
  "id": 1,
  "name": "Acura",
  "model_count": 6,
  "trim_count": 80,
  "first_year": 2022,
  "last_year": 2024,
  "min_msrp": 27300,
  "max_msrp": 169500,
  "countries_of_origin": [
    "Japan"
  ]
}

Includes all fields from List makes, plus:

Field	Type	Description
min_msrp	integer	Lowest base price across all trims
max_msrp	integer	Highest base price across all trims
countries_of_origin	string[]	Countries where the make's cars are built

Returns 404 if the make does not exist.

List models of a make

Code
GET /api/makes/{makeId}/models

Parameters

Name	In	Type	Description
makeId	path	integer	Make ID
year	query	integer	Optional. Only models offered in this model year

Example

Code
curl "http://localhost:3000/api/makes/1/models?year=2024"

Code
{
  "data": [
    {
      "id": 2,
      "name": "Integra",
      "trim_count": 5,
      "first_year": 2024,
      "last_year": 2024,
      "min_msrp": 31800,
      "max_msrp": 51800,
      "body_types": [
        "Hatchback"
      ]
    },
    {
      "id": 3,
      "name": "MDX",
      "trim_count": 8,
      "first_year": 2024,
      "last_year": 2024,
      "min_msrp": 50150,
      "max_msrp": 73800,
      "body_types": [
        "SUV"
      ]
    }
  ],
  "count": 4
}

Fields

Field	Type	Description
id	integer	Model ID
name	string	Model name
trim_count	integer	Number of trims
first_year / last_year	integer	Model year range
min_msrp / max_msrp	integer	Base price range
body_types	string[]	Body styles offered

When year is set, all counts and ranges cover that year only.

Returns 404 if the make does not exist.