{
  "openapi": "3.1.0",
  "info": {
    "title": "Vehicle Recalls API",
    "version": "1.0.0",
    "description": "Every NHTSA recall since 1967 and 2.24 million owner complaints by make, model and year.\n\nEvery US vehicle recall since 1967 and 2.24 million owner complaints, straight from NHTSA and self-hosted: 30,271 recall campaigns with defect, consequence and remedy summaries, units affected, completion rates and the high-signal do-not-drive and fire-risk-when-parked flags — plus the applicability data that answers the question drivers actually ask: which recalls affect a 2019 Honda CR-V? 178k campaign-to-vehicle rows let you query recalls by make, model and year directly; every campaign links to its nhtsa.gov page and lists its affected vehicles. The complaints side adds the safety story: search 2.24M owner complaints by vehicle, component, state or crash/fire involvement, and pull a one-call safety profile per vehicle — total complaints, crashes, fires, injuries, deaths and the top complained-about components (the 2014 Jeep Cherokee's POWER TRAIN, the Bolt EV's ELECTRICAL SYSTEM). Refreshes daily from official NHTSA feeds — new campaigns appear the day NHTSA receives them. Built for dealerships, used-car marketplaces, insurance, fleet tools and consumer apps. Public-domain source data; self-hosted — no third-party calls at request time.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/vehicle-recalls.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/vehicle-recalls"
  },
  "servers": [
    {
      "url": "https://api-vehicle-recalls.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Transportation",
      "description": "Vehicle Recalls API belongs to the Transportation category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/sources": {
      "get": {
        "operationId": "dataSources",
        "summary": "Data Sources",
        "description": "Data Sources endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/data-sources"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "count": 2,
                  "sources": [
                    {
                      "slug": "nhtsa-complaints",
                      "name": "NHTSA ODI Complaints flat file",
                      "publisher": "US National Highway Traffic Safety Administration",
                      "licence": "US Government work - public domain",
                      "source_url": "https://www.nhtsa.gov/nhtsa-datasets-and-apis",
                      "file_url": "https://static.nhtsa.gov/odi/ffdd/cmpl/FLAT_CMPL.zip",
                      "cadence": "daily file; monthly re-seed here",
                      "record_count": 2241804,
                      "retrieved_at": "2026-09-02"
                    },
                    {
                      "slug": "nhtsa-recalls",
                      "name": "NHTSA Recalls Data (DOT datahub)",
                      "publisher": "US National Highway Traffic Safety Administration",
                      "licence": "US Government work - public domain",
                      "source_url": "https://datahub.transportation.gov/d/6axg-epim",
                      "file_url": "https://datahub.transportation.gov/resource/6axg-epim.json",
                      "cadence": "daily",
                      "record_count": 30271,
                      "retrieved_at": "2026-09-02"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/complaints/{odino}": {
      "get": {
        "operationId": "getComplaint",
        "summary": "Get Complaint",
        "description": "Get Complaint endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/get-complaint"
        },
        "parameters": [
          {
            "name": "odino",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "11760811"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "odino": 11760811,
                  "count": 1,
                  "records": [
                    {
                      "odino": 11760811,
                      "make": "CHEVROLET",
                      "model": "BOLT EV",
                      "year": 2017,
                      "component": "STEERING",
                      "crash": false,
                      "fire": false,
                      "injured": 0,
                      "deaths": 0,
                      "fail_date": "2026-03-05",
                      "date_added": "2026-08-30",
                      "location": {
                        "city": "Baldwin Park",
                        "state": "CA"
                      },
                      "miles": 0,
                      "summary": "The steering rack on the Chevrolet Bolt EV does not return to center on turns. Over the course of the past 25k miles, my particular model has slowly began to lock up on deep turns. This occurs on sharp rights, lefts, and on both on and off ramps - especially the ones that loop around. The steering r"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/recalls/{nhtsa_id}": {
      "get": {
        "operationId": "getRecallCampaign",
        "summary": "Get Recall Campaign",
        "description": "Get Recall Campaign endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/get-recall-campaign"
        },
        "parameters": [
          {
            "name": "nhtsa_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "26V558000"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "recall": {
                    "nhtsa_id": "26V558000",
                    "report_received": "2026-09-01",
                    "manufacturer": "Tesla, Inc.",
                    "subject": "Front Suspension Lateral Link May Separate",
                    "component": "SUSPENSION",
                    "recall_type": "Vehicle",
                    "potentially_affected": 19,
                    "do_not_drive": false,
                    "fire_risk_when_parked": false,
                    "mfr_campaign_number": "SB-26-31-004",
                    "defect_summary": "Tesla, Inc. (Tesla) is recalling certain 2026 Model Y vehicles. One or more front suspension lateral link fasteners may not have been properly tightened, allowing the lateral link to loosen or separate from the sub-frame.",
                    "consequence_summary": "A lateral link separation could shift the wheel alignment, causing a loss of vehicle control and increasing the risk of a crash.",
                    "corrective_action": "Tesla Service will tighten or replace the fasteners and check wheel the alignment, free of charge. In addition, Tesla Service will replace any related parts that may have been damaged as necessary. Owner notification letters are expected to be mailed October 30, 2026. Owners may contact Tesla customer service at 1-877-798-3752. Tesla's number for this recall is SB-26-31-004.",
                    "completion_rate": 0,
                    "nhtsa_link": "https://www.nhtsa.gov/recalls?nhtsaId=26V558000",
                    "affected_vehicles": [
                      {
                        "make": "TESLA",
                        "model": "MODEL Y",
                        "year": 2026
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/recalls/latest": {
      "get": {
        "operationId": "latestRecalls",
        "summary": "Latest Recalls",
        "description": "Latest Recalls endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/latest-recalls"
        },
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "count": 3,
                  "results": [
                    {
                      "nhtsa_id": "26V558000",
                      "report_received": "2026-09-01",
                      "manufacturer": "Tesla, Inc.",
                      "subject": "Front Suspension Lateral Link May Separate",
                      "component": "SUSPENSION",
                      "recall_type": "Vehicle",
                      "potentially_affected": 19,
                      "do_not_drive": false,
                      "fire_risk_when_parked": false
                    },
                    {
                      "nhtsa_id": "26V556000",
                      "report_received": "2026-08-31",
                      "manufacturer": "Blue Bird Body Company",
                      "subject": "Wheelchair Lift May Inadvertently Move",
                      "component": "EQUIPMENT ADAPTIVE/MOBILITY",
                      "recall_type": "Vehicle",
                      "potentially_affected": 82,
                      "do_not_drive": false,
                      "fire_risk_when_parked": false
                    },
                    {
                      "nhtsa_id": "26V552000",
                      "report_received": "2026-08-28",
                      "manufacturer": "Jayco, Inc.",
                      "subject": "Incorrect GAWR on Certification Label",
                      "component": "EQUIPMENT",
                      "recall_type": "Vehicle",
                      "potentially_affected": 8,
                      "do_not_drive": false,
                      "fire_risk_when_parked": false
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/recalls/components": {
      "get": {
        "operationId": "recallComponents",
        "summary": "Recall Components",
        "description": "Recall Components endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/recall-components"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "count": 8,
                  "components": [
                    {
                      "component": "EQUIPMENT",
                      "campaigns": 3193
                    },
                    {
                      "component": "ELECTRICAL SYSTEM",
                      "campaigns": 2348
                    },
                    {
                      "component": "STEERING",
                      "campaigns": 1646
                    },
                    {
                      "component": "SERVICE BRAKES, HYDRAULIC",
                      "campaigns": 1577
                    },
                    {
                      "component": "SUSPENSION",
                      "campaigns": 1436
                    },
                    {
                      "component": "POWER TRAIN",
                      "campaigns": 1377
                    },
                    {
                      "component": "FUEL SYSTEM, GASOLINE",
                      "campaigns": 1362
                    },
                    {
                      "component": "STRUCTURE",
                      "campaigns": 1157
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/complaints": {
      "get": {
        "operationId": "searchComplaints",
        "summary": "Search Complaints",
        "description": "Search Complaints endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/search-complaints"
        },
        "parameters": [
          {
            "name": "component",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "crash",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fire",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          },
          {
            "name": "make",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "CHEVROLET"
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BOLT EV"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2019"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "total": 241,
                  "page": 1,
                  "limit": 20,
                  "count": 3,
                  "results": [
                    {
                      "odino": 11749605,
                      "make": "CHEVROLET",
                      "model": "BOLT EV",
                      "year": 2019,
                      "component": "STEERING",
                      "crash": false,
                      "fire": false,
                      "injured": 0,
                      "deaths": 0,
                      "fail_date": "2026-07-10",
                      "date_added": "2026-07-10",
                      "location": {
                        "city": "Swarthmore",
                        "state": "PA"
                      },
                      "miles": null,
                      "summary": "Steering wheel does not return to center on turns when driving at low speeds."
                    },
                    {
                      "odino": 11743944,
                      "make": "CHEVROLET",
                      "model": "BOLT EV",
                      "year": 2019,
                      "component": "STEERING",
                      "crash": false,
                      "fire": false,
                      "injured": 0,
                      "deaths": 0,
                      "fail_date": "2025-10-30",
                      "date_added": "2026-06-13",
                      "location": {
                        "city": "Los Angeles",
                        "state": "CA"
                      },
                      "miles": null,
                      "summary": "Steering wheel does not return to center after making a turn. Over time the steering rack fails leading to a steering wheel that will not return to center even when force is applied to wheel. The dealership is charging $3-4k to fix this safety issue."
                    },
                    {
                      "odino": 11738509,
                      "make": "CHEVROLET",
                      "model": "BOLT EV",
                      "year": 2019,
                      "component": "SERVICE BRAKES",
                      "crash": false,
                      "fire": false,
                      "injured": 0,
                      "deaths": 0,
                      "fail_date": "2026-05-17",
                      "date_added": "2026-05-18",
                      "location": {
                        "city": "Waxhaw",
                        "state": "NC"
                      },
                      "miles": null,
                      "summary": "when driving my car from the airport at Bradley International in CT  (parked for a week),  I experienced a terrible vibration in the steering wheel which has been intermittent. The vibration went away at lower speeds. I brought the car in to the shop on 5/18/2026 with 74,000 miles on the car. They…"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/recalls": {
      "get": {
        "operationId": "searchRecalls",
        "summary": "Search Recalls",
        "description": "Search Recalls endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/search-recalls"
        },
        "parameters": [
          {
            "name": "component",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "do_not_drive",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          },
          {
            "name": "make",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "HONDA"
          },
          {
            "name": "manufacturer",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "CR-V"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Vehicle"
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2019"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "total": 8,
                  "page": 1,
                  "limit": 20,
                  "count": 3,
                  "results": [
                    {
                      "nhtsa_id": "26V332000",
                      "report_received": "2026-05-21",
                      "manufacturer": "Honda (American Honda Motor Co.)",
                      "subject": "Air Bags May Deploy Unintentionally During a Crash",
                      "component": "AIR BAGS",
                      "recall_type": "Vehicle",
                      "potentially_affected": 98892,
                      "do_not_drive": false,
                      "fire_risk_when_parked": false
                    },
                    {
                      "nhtsa_id": "23V858000",
                      "report_received": "2023-12-18",
                      "manufacturer": "Honda (American Honda Motor Co.)",
                      "subject": "Fuel Pump May Fail",
                      "component": "FUEL SYSTEM, GASOLINE",
                      "recall_type": "Vehicle",
                      "potentially_affected": 2490460,
                      "do_not_drive": false,
                      "fire_risk_when_parked": false
                    },
                    {
                      "nhtsa_id": "23V158000",
                      "report_received": "2023-03-09",
                      "manufacturer": "Honda (American Honda Motor Co.)",
                      "subject": "Seat Belt Buckle May Not Latch",
                      "component": "SEAT BELTS",
                      "recall_type": "Vehicle",
                      "potentially_affected": 448613,
                      "do_not_drive": false,
                      "fire_risk_when_parked": false
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/complaints/stats": {
      "get": {
        "operationId": "vehicleSafetyProfile",
        "summary": "Vehicle Safety Profile",
        "description": "Vehicle Safety Profile endpoint of the Vehicle Recalls API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/vehicle-recalls/vehicle-safety-profile"
        },
        "parameters": [
          {
            "name": "make",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "CHEVROLET"
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BOLT EV"
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2019"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "make": "CHEVROLET",
                  "model": "BOLT EV",
                  "year": 2019,
                  "totals": {
                    "complaints": 241,
                    "crashes": 2,
                    "fires": 15,
                    "injured": 5,
                    "deaths": 0
                  },
                  "top_components": [
                    {
                      "component": "ELECTRICAL SYSTEM",
                      "complaints": 80
                    },
                    {
                      "component": "STEERING",
                      "complaints": 45
                    },
                    {
                      "component": "FUEL/PROPULSION SYSTEM",
                      "complaints": 44
                    },
                    {
                      "component": "UNKNOWN OR OTHER",
                      "complaints": 20
                    },
                    {
                      "component": "POWER TRAIN",
                      "complaints": 13
                    },
                    {
                      "component": "VISIBILITY/WIPER",
                      "complaints": 4
                    },
                    {
                      "component": "SERVICE BRAKES",
                      "complaints": 4
                    },
                    {
                      "component": "FORWARD COLLISION AVOIDANCE: WARNINGS",
                      "complaints": 4
                    },
                    {
                      "component": "SEAT BELTS",
                      "complaints": 3
                    },
                    {
                      "component": "LANE DEPARTURE: BLIND SPOT DETECTION",
                      "complaints": 3
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}