# NHTSA Vehicle Models by Make and Year

> NHTSA Vehicle Models by Make and Year is a paid API for AI agents from 2s.io, paid per call via x402, $0.0024/call, status unknown (last checked 2026-09-14).

Returns all models a vehicle manufacturer sold in a given model year, using NHTSA's vPIC taxonomy database with canonical Model IDs and Make IDs.

## Facts

- Endpoint: GET https://2s.io/api/vehicle/models
- Price: $0.0024/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-ca69a26e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AK5yNH0jNJCg2HXr5vy-Q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-ca69a26e
```

Example prompt: What are all the models Honda sold in model year 2019? I need the NHTSA model names and IDs.

## When to prefer this

Use this endpoint when you know a vehicle's make and model year but not the specific model, and need to enumerate valid NHTSA model options — especially as a discovery step before VIN decoding or as input validation for recall/complaint lookups. Prefer this over a VIN decode endpoint when no VIN is available.

## Known failure modes

- Unknown or misspelled make returns empty model list or error
- Model year outside 1949–2099 range returns validation error
- Make with no NHTSA records for the given year returns empty array
- Network or upstream NHTSA API timeout returns 5xx error

## How this service works

Enumerate every model a manufacturer sold in a given model year via NHTSA's vPIC taxonomy database. Returns canonical NHTSA Model IDs + names plus the Make ID + name for reference. Useful as a discovery step before VIN decode (when the agent only knows make + year) or as input validation for vehicle.recalls / vehicle.complaints. Backed by NHTSA.gov; data is public-domain US government records.

## Output

A list of vehicle models for the specified make and model year, each with a canonical NHTSA Model ID, model name, Make ID, and make name — sourced from NHTSA's vPIC taxonomy database.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "make": "Toyota",
   "modelYear": 2020
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "make",
      "modelYear"
     ],
     "properties": {
      "make": {
       "type": "string",
       "maxLength": 40,
       "minLength": 2,
       "description": "Vehicle make. Case-insensitive on NHTSA side. Examples: \"Honda\", \"Tesla\", \"Ford\"."
      },
      "modelYear": {
       "type": "integer",
       "maximum": 2099,
       "minimum": 1949,
       "description": "4-digit model year."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-ca69a26e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)
