Year make model

Year Make Model Options

Populate Year, Make, Model, and Variant dropdown menus. Each response returns exactly one layer. `dimension` is optional — when omitted, the response shape is inferred from `make`/`model`/`year`. Required filters help you get better, more relevant results. `year`, `make`, and `model` can be combined for reversed lookups (e.g. years for a given make+model).

Checking account...
GET
/v1/ymm-options

Populate Year, Make, Model, and Variant dropdown menus. Each response returns exactly one layer. dimension is optional — when omitted, the response shape is inferred from make/model/year. Required filters help you get better, more relevant results. year, make, and model can be combined for reversed lookups (e.g. years for a given make+model).

Authorization

key<token>

Your CarsXE API key, passed as the key query parameter.

In: query

Query Parameters

dimension?string

Return exactly this array when required filters are present. If omitted, the response is inferred automatically from make/model/year.

Value in"years" | "makes" | "models" | "trims" | "variants"
year?string

Filter to a specific manufacturing year. Required when filtering by model without make.

make?string

Filter to a specific manufacturer (e.g., Toyota, Ford, Lexus). Required for dimension=models.

model?string

Filter to a specific model (e.g., Camry, F-150, LX). Required for dimension=trims and for dimension=variants unless both year and make are set.

trim?string

Optional substring filter on trim names. Only applied when querying dimension=trims or dimension=variants.

Response Body

application/json

application/json

application/json

application/json

application/json

{
  "success": true,
  "input": {
    "year": 2026,
    "make": "Toyota",
    "model": "Tacoma"
  },
  "variants": [
    "Tacoma Limited",
    "Tacoma SR",
    "Tacoma SR5",
    "Tacoma TRD Off-Road",
    "Tacoma TRD PreRunner",
    "Tacoma TRD Pro",
    "Tacoma TRD Sport",
    "Tacoma Trailhunter"
  ]
}

{
  "success": false,
  "message": "Invalid dimension. Must be one of: years, makes, models, trims, variants."
}

{
  "success": false,
  "message": "Missing API key"
}

{
  "success": false,
  "message": "API usage limit exceeded",
  "usage": {
    "current": 1000,
    "limit": 1000,
    "remaining": 0
  }
}
{
  "success": false,
  "message": "Could not fetch data"
}