Department of Transportation

NHTSA WebAPIs

NHTSA
in support of Open Government Directive

NHTSA Datasets


 

New Car Assessment Program (NCAP) - 5 Star Safety Ratings


NCAP rates vehicles to determine crash worthiness and rollover safety. The safety ratings are gathered during controlled crash and rollover tests conducted at NHTSA research facilities. Vehicles with a rating of five stars indicate the highest safety rating, whereas a one star indicates the lowest rating.

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. The New Car Assessment Program provides consumers with important information in making a new car purchase, and for comparable vehicle models it provides a direct comparison of the crashworthyness of vehicles. Information from this program also exists on the required labels on each new vehicle for sale .


Implementations

  
Approach A. Get by Model Year, Make, Model
Step 1 : Get available vehicle variants for a selected Model Year, Make and Model Make the request to get the crash tested vehicle variants for the Model Year, Maker and Model combination.
for xml - /api/SafetyRatings/modelyear/2013/make/Acura/model/rdx?format=xml
for json - /api/SafetyRatings/modelyear/2013/make/Acura/model/rdx?format=json

Response Fields   Response is a list of vehicle variants for Model Year, Maker and Model with their VehicleId and description of the variant.
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Step 2 : Get the Safety Ratings for the selected variant Now that you have the VehicleId of the precise model that you to look up, go ahead and make the request to get the Safety Ratings for the required vehicle variant by passing in the VehicleId.
for xml - /api/SafetyRatings/VehicleId/7520?format=xml
for json - /api/SafetyRatings/VehicleId/7520?format=json

Response Fields   Response is a list of Safety Ratings for the given vehicle variant.
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/SafetyRatings?format=xml
for json - /api/SafetyRatings?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/SafetyRatings/modelyear/2013?format=xml
for json - /api/SafetyRatings/modelyear/2013?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/SafetyRatings/modelyear/2013/make/Acura?format=xml
for json - /api/SafetyRatings/modelyear/2013/make/Acura?format=json

Response Fields   Response is a list of Safety Ratings for the given Model Year, Maker and Model
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Step 4 : Get available vehicle variants for a selected Model Year, Make and Model Make the request to get the crash tested vehicle variants for the Model Year, Maker and Model combination.
for xml - /api/SafetyRatings/modelyear/2013/make/Acura/model/rdx?format=xml
for json - /api/SafetyRatings/modelyear/2013/make/Acura/model/rdx?format=json

Response Fields   Response is a list of vehicle variants for Model Year, Maker and Model with their VehicleId and description of the variant.
Response Sample  
Working Sample   XML      JSON      JSV      CSV     
Step 5 : Get the Safety Ratings for the selected variant Now that you have the VehicleId of the precise model that you to look up, go ahead and make the request to get the Safety Ratings for the required vehicle variant by passing in the VehicleId.
for xml - /api/SafetyRatings/VehicleId/7520?format=xml
for json - /api/SafetyRatings/VehicleId/7520?format=json

Response Fields   Response is a list of Safety Ratings for the given vehicle variant.
Response Sample  
Working Sample   XML      JSON      JSV      CSV     

Request Specification

 
CRASHTESTEDVEHICLE 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