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. Billing: most calls cost 1 unit. dimension=variants with year + make (no model) costs 1 unit per model; the response includes modelCount. 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).

get/v1/ymm-options

Query parameters

dimension'years' | 'makes' | 'models' | 'trims' | 'variants'

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

yearstring

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

makestring

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

modelstring

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.

trimstring

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

Response

Distinct values for the requested (or inferred) dimension(s).

successboolean

inputobject

messagestring

Optional guidance when the returned layer differs from the requested dimension or when explaining how to get better results.

yearsinteger[]

makesstring[]

modelsstring[]

trimsstring[]

variantsstring[]

modelCountinteger

Present only for bulk variants (dimension=variants + year + make, no model). Number of distinct models, which is also the amount billed — except a zero-match query, which returns 0 but still bills a minimum of 1 unit.