CAcarsxe
Year Make Model

Year Make Model Options

Changed on

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: ordinary successful lookups use 1 credit. dimension=variants with year + make (no model) uses 1 credit per distinct model returned; 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). Successful responses use a minimum of 1 credit even when no models match. Failed requests do not use credits.

get/v1/ymm-options

Request

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 returned. Successful bulk variants use 1 credit per distinct model. Successful responses use a minimum of 1 credit even when no models match. Failed requests do not use credits.

Changes