# Vehicle Safety API
> Official US vehicle safety data from NHTSA: look up safety recalls (campaign number, affected component, consequence and remedy), owner complaints, and NCAP 5-star crash-test ratings (overall, frontal, side and rollover) for any make, model and year. Ideal for car marketplaces, dealer tools, insurance and consumer-safety apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/vehiclesafety-api/..."
```

## Pricing
- **Free** (Free) — 30,000 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 350,000 calls/Mo, 4 req/s
- **Pro** ($21/Mo) — 2,000,000 calls/Mo, 12 req/s
- **Mega** ($55/Mo) — 12,000,000 calls/Mo, 40 req/s

## Endpoints

### Safety

#### `GET /v1/complaints` — Owner complaints for a make/model/year

**Parameters:**
- `make` (query, required, string) — Vehicle make
- `model` (query, required, string) — Vehicle model
- `year` (query, required, string) — Model year (1990-2030)
- `limit` (query, optional, string) — Max complaints (1-100, default 25)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vehiclesafety-api/v1/complaints"
```

#### `GET /v1/ratings` — NCAP crash-test star ratings for a make/model/year

**Parameters:**
- `make` (query, required, string) — Vehicle make Example: `honda`
- `model` (query, required, string) — Vehicle model Example: `accord`
- `year` (query, required, string) — Model year (1990-2030) Example: `2018`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vehiclesafety-api/v1/ratings?make=honda&model=accord&year=2018"
```

**Response:**
```json
{
    "data": {
        "make": "honda",
        "year": 2018,
        "count": 1,
        "model": "accord",
        "vehicles": [
            {
                "vehicle_id": 12650,
                "description": "2018 Honda Accord 4 DR FWD",
                "side_driver": "5",
                "front_driver": "5",
                "overall_rating": "5",
                "side_passenger": "5",
                "front_passenger": "5",
                "rollover_rating": "5",
                "overall_side_crash": "5",
                "overall_front_crash": "5"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T23:42:24.874Z",
        "request_id": "98054ddf-4a8d-4baa-a4d7-8eaf9dcb666f"
    },
    "status": "ok",
    "message": "Safety ratings retrieved",
    "success": true
}
```

#### `GET /v1/recalls` — Safety recalls for a make/model/year

**Parameters:**
- `make` (query, required, string) — Vehicle make Example: `honda`
- `model` (query, required, string) — Vehicle model Example: `accord`
- `year` (query, required, string) — Model year (1990-2030) Example: `2018`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vehiclesafety-api/v1/recalls?make=honda&model=accord&year=2018"
```

**Response:**
```json
{
    "data": {
        "make": "honda",
        "year": 2018,
        "count": 6,
        "model": "accord",
        "recalls": [
            {
                "notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236 (TTY 1-800-424-9153), or go to www.safercar.gov.",
                "remedy": "Honda will notify owners and dealers will replace the fuel pump assembly, free of charge.  The recall began July 22, 2020.  Owners may contact Honda customer service at 1-888-234-2138.",
                "summary": "Honda (American Honda Motor Co.) is recalling certain 2018-2019 Acura NSX, 2019 Acura RDX, RLX and RLX Sport Hybrid, 2018-2019 Honda Accord, Civic Hatchback, Civic Type R and HR-V, 2019-2020 Insight and 2019 Fit vehicles.  The low-pressure fuel pump inside the fuel tank may fail.",
                "component": "FUEL SYSTEM, GASOLINE:DELIVERY:FUEL PUMP",
                "consequence": "If the fuel pump fails, the engine can stall while driving, increasing the risk of a crash.",
                "manufacturer": "Honda (American Honda Motor Co.)",
                "campaign_number": "20V314000",
                "report_received_date": "28/05/2020"
            },
            {
                "notes": "Owners may also contact the National Highway Traffic Safety Administration Vehicle Safety Hotline at 1-888-327-4236 (TTY 1-800-424-9153), or go to www.safercar.gov.",
                "remedy": "Honda will notify ow
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Data source & endpoint reference

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vehiclesafety-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "US vehicles only. Distinct from VIN-decode / specifications.",
        "source": "US NHTSA (api.nhtsa.gov)",
        "endpoints": {
            "/v1/ratings": "NCAP 5-star crash-test ratings (overall, frontal, side, rollover) for make/model/year.",
            "/v1/recalls": "Safety recalls for make/model/year.",
            "/v1/complaints": "Owner complaints for make/model/year (may be slow for high-volume vehicles)."
        },
        "description": "Vehicle recalls, owner complaints and NCAP crash-test star ratings"
    },
    "meta": {
        "timestamp": "2026-05-30T23:42:25.337Z",
        "request_id": "7153b2e2-d20d-46ee-b1fa-e7931434a430"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/vehiclesafety-api
OpenAPI spec: https://www.oanor.com/api/vehiclesafety-api/openapi.json