Department of Transportation

NHTSA WebAPIs

NHTSA
in support of Open Government Directive

NHTSA Datasets


 

NHTSA's Office of Defects Investigation (ODI) - Recalls


Manufacturers who determine that a product or piece of original equipment either has a safety defect or is not in compliance with Federal safety standards are required to notify the National Highway Traffic Safety Administration (NHTSA) within 5 business days. NHTSA requires that manufacturers file a Defect and Noncompliance report as well as quarterly recall status reports, in compliance with Federal Regulation 49 (the National Traffic and Motor Safety Act) Part 573, which identifies the requirements for safety recalls. This information is stored in the NHTSA database. Use this data to search for recall information related to: • Specific NHTSA campaigns • Product types

NHTSA is an organization under the U.S. Department of Transportation (DOT) whose mission is to save lives, prevent injuries and reduce economic costs due to road traffic crashes, through education, research, safety standards and enforcement activity. NHTSA is dedicated to achieving the highest standards of excellence in motor vehicle and highway safety.


Implementations

  
Approach A. Get by Model Year, Make, Model
Make the request to get the Recalls for the required combination of Model Year, Maker and Model.
for xml - /api/Recalls/vehicle/modelyear/2000/make/saturn/model/ls?format=xml
for json - /api/Recalls/vehicle/modelyear/2000/make/saturn/model/ls?format=json

Response Fields   Response is a list of Recalls for the given Model Year, Maker and Model
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Approach B. Get by Model Year, Make, Model
Step 1 : Get all Model Years Request a list of available Model Years for a given product type (Vehicle).
for xml - /api/Recalls/vehicle?format=xml
for json - /api/Recalls/vehicle?format=json

Response Fields   Response is a list of available Model Years in the repository. Use a Model Year from this list to use in the next step.
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Step 2 : Get all Makes for the Model Year Request a list of vehicle Makers by providing a specific vehicle ModelYear.
for xml - /api/Recalls/vehicle/modelyear/2000?format=xml
for json - /api/Recalls/vehicle/modelyear/2000?format=json

Response Fields   Response is a list of vehicle Makers for that Model Year. Use the Model Year and a Maker from this list to use in the next step.
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Step 3 : Get all Model for the Make and Model Year Request a list of vehicle Models by providing the vehicle Model Year and Maker.
for xml - /api/Recalls/vehicle/modelyear/2000/make/saturn?format=xml
for json - /api/Recalls/vehicle/modelyear/2000/make/saturn?format=json

Response Fields   Response is a list of Recalls for the given Model Year, Maker and Model
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Step 4 : Get all recalls for the selected Model Year, Make, Model Now that you have all three key piece of information (Model Year, Maker, Model), go ahead and make the request to get the Recalls for the required combination.
for xml - /api/Recalls/vehicle/modelyear/2012/make/bmw/model/3-series?format=xml
for json - /api/Recalls/vehicle/modelyear/2012/make/bmw/model/3-series?format=json

Response Fields   Response is a list of Recalls for the given Model Year, Maker and Model.
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Approach C. Get by NHTSA Campaign Number
Step 1 :Get all recalls as part of a NHTSA Recall Campaign Number Request a list of recalls by providing the NHTSA Recall Campaign Number.
for xml - /api/Recalls/vehicle/campaignnumber/12v176000?format=xml
for json - /api/Recalls/vehicle/campaignnumber/12v176000?format=json

Response Fields   Response is a list of Recalls for the specified NHTSA Recall Campaign Number.
Response Sample  
Working Sample   XML      JSON      JSV      CSV     

Request Specification

 
RECALLNUMBER XML      JSON      JSV      CSV      SOAP1.1      SOAP1.2     
RECALLPRODUCT XML      JSON      JSV      CSV      SOAP1.1      SOAP1.2     

Notes

 
  • Color codes to understand each part of the request url:
    RED - Method Name
    BLUE - Type filter (if any)
    GREEN - applicable parameters
    BROWN - extended paramaters AND format of the response expected

  • Special Characters
          & - Replace character ampresand (&) value in the parameter with underscore (_)
          Space, Hyphens - Use these characters in the parameter values as is
         
  • Version - These APIs are at early stages with enhancements in plan. Check for updates often.
 DOT- NHTSA:  All Rights Reserved @ 2012 - 2013