Vehicle Lookup

Overview

The Vehicle Lookup endpoints resolve fuzzy make, model, and year inputs into exact identifiers that can be used with plan search. Use these endpoints when you have user-entered vehicle information that may not match exactly (e.g., "f150" instead of "F-150").

All Vehicle Lookup endpoints return cached data and respond in under 50ms.

Available Endpoints

Endpoint	Description
GET /api/v2/Partners/Vehicles/Makes	List all available vehicle makes
GET /api/v2/Partners/Vehicles/Makes/{makeId}/Models	List models and available years for a make
GET /api/v2/Partners/Vehicles/Lookup	Resolve fuzzy inputs into exact identifiers

For request/response details, see the API Reference.

Workflow

Use these endpoints in sequence to build a vehicle selection UI, or use the Lookup endpoint directly to resolve free-text input.

Option A: Browsable Selection

1. List makes — call GET /Makes to get all available makes sorted alphabetically
2. List models — call GET /Makes/{makeId}/Models to get models with available years for the selected make
3. Use in plan search — pass the exact make, model, and year to a plan search endpoint

Option B: Fuzzy Resolution

Call GET /Lookup?make={make}&model={model}&year={year} to resolve user-typed values directly. The make and model parameters are required; year is optional but recommended for precise results.

Confidence Levels

The Lookup endpoint returns matches with confidence levels indicating how closely the input matched:

Confidence	Description	Example
HIGH	Exact case-insensitive match	"ford" matches "FORD"
MEDIUM	Normalized match after stripping special characters	"f150" matches "F-150"
LOW	Partial or contains match	"merc" matches "MERCURY" and "MERCEDES-BENZ"

Returns up to 5 matches ordered by confidence descending. When the match is ambiguous, the response includes suggestions with alternative model names.

Use the yearsAvailable array from the Models or Lookup response to validate the user's vehicle year before calling plan search.