|
|
|
NHTSA's Office of Defects Investigation (ODI) - Complaints
Complaint information entered into NHTSA-ODI's vehicle owner's complaint database is used with other data sources to identify safety issues that warrant investigation and to determine if a safety-related defect trend exists. Complaint information is also analyzed to monitor existing recalls for proper scope and adequacy.
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.
| | |
|
Approach A.
Get by Model Year, Make, Model
|
| |
|
|
Make the request to get the Complaints for the required combination of Model Year, Maker and Model.
for xml - /api/Complaints/vehicle/modelyear/2012/make/acura/model/rdx?format=xml
for json - /api/Complaints/vehicle/modelyear/2012/make/acura/model/rdx?format=json
|
|
Response Fields
|
Response is a list of Complaints 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/Complaints/vehicle?format=xml
for json - /api/Complaints/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/Complaints/vehicle/modelyear/2012?format=xml
for json - /api/Complaints/vehicle/modelyear/2012?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/Complaints/vehicle/modelyear/2012/make/acura?format=xml
for json - /api/Complaints/vehicle/modelyear/2012/make/acura?format=json
|
|
Response Fields
|
Response is a list of Complaints for the given Model Year, Maker and Model
|
|
Response Sample
|
|
|
Working Sample
|
XML
JSON
JSV
CSV
|
|
| |
|
Step 4 : Get all complaints 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 Complaints for the required combination.
for xml - /api/Complaints/vehicle/modelyear/2012/make/acura/model/rdx?format=xml
for json - /api/Complaints/vehicle/modelyear/2012/make/acura/model/rdx?format=json
|
|
Response Fields
|
Response is a list of Complaints for the given Model Year, Maker and Model.
|
|
Response Sample
|
|
|
Working Sample
|
XML
JSON
JSV
CSV
|
|
|
Approach C.
Get by ODI Number
|
| |
|
Step 1 :Get all complaints by its ODI Number
|
Request a list of complaints by providing its ODI Number.
for xml - /api/Complaints/vehicle/odinumber/10457576?format=xml
for json - /api/Complaints/vehicle/odinumber/10457576?format=json
|
|
Response Fields
|
Response is a list of Complaints for the specified ODI Number.
|
|
Response Sample
|
|
|
Working Sample
|
XML
JSON
JSV
CSV
|
|
|
|
-
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.
|
|