--- title: "VIN Inspections- Returns detailed information about inspections of your VIN shipments." method: GET path: "/v1/vin-inspections" tags: ["AUTOMOTIVE"] --- # VIN Inspections- Returns detailed information about inspections of your VIN shipments. `GET /v1/vin-inspections` ## Request - Base URL: `https://api.bnsf.com:6443` - URL: `https://api.bnsf.com:6443/v1/vin-inspections` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Query parameters - `vinList` string, required ## Response `200` **OK** The request has succeeded. - VinInspections: Vin Inspections - `jobStatus` integer - `jobStatusDescription` string - `resultSet` object[] - `aiagDamageAreaCode` string: Code defined by the AIAG (Automotive Industry Action Group) to specify the area on a vehicle that has been damaged during its transportation. - `aiagDamageAreaDescription` string: Description of the area on a vehicle that has been damaged during its transportation, as defined by the AIAG (Automotive Industry Action Group). - `aiagDamageSeverityCode` string: Code to indicate the severity of the damage identified on a vehicle as it changed possession during its transportation, as defined by the AIAG (Automotive Industry Action Group). - `aiagDamageSeverityDescription` string: Description of the severity of the damage identified on a vehicle as it changed possession during its transportation, as defined by the AIAG (Automotive Industry Action Group). - `aiagDamageTypeCode` string: Code to designate the type of damage identified on a vehicle as it changed possession during its transportation, as defined by the AIAG (Automotive Industry Action Group). - `aiagDamageTypeDescription` string: Type of damage identified on a vehicle as it changed possession during its transportation, as defined by the AIAG (Automotive Industry Action Group). - `cstVehicleInspectionTypeCode` string: Type of inspection made to a vehicle transported by BNSF, as defined in Customer Shipment Tracking. - `cstVehicleInspectionTypeDescription` string: Description of the type of inspection performed on a vehicle transported by BNSF, as defined in Customer Shipment Tracking. - `vehicleInspectionDate` string: Date of the inspection of a vehicle transported by BNSF. - `vehicleInspectiontime` string: Time of the inspection of a vehicle transported by BNSF. - `vin` string: A vehicle identification number (VIN) (also called a chassis number or frame number) is a unique code, including a serial number, used by the automotive industry to identify individual motor vehicles, towed vehicles, motorcycles, scooters and mopeds, as defined in ISO 3779 (content and structure) and ISO 4030 (location and attachment). - `rowCount` string ## Other responses - `400`: **Bad Request** The request could not be understood by the server due to incorrect syntax. Do not repeat the request without modifications. - `403`: Unauthorized request. Here are the most common causes: * You are getting 403 Access Denied. * It takes a few days for us to get you set up after you register. When set up is complete, you will receive an email letting you know. If you have not received the email, please wait up to five business days. Let us know via API Support if you still have not received the email after five business days. * You can also get this error if your certificate is not configured properly on your side. Please review the Mutual Authentication in the Getting Started section of our documentation. * You are getting 403 "message": "Insufficient privileges" when accessing a restricted service for which you do not have permission. You can use our Registration form to request access. Be sure to explain the situation in the "Please explain how you intend to use the API" field. - `404`: **Not Found** The server cannot find the requested resource (URI). That is, the address of the endpoint in your request does not exist. Please consult the documentation. - `405`: **Method Not Allowed** The request HTTP method is known by the server but has been disabled and cannot be used for that resource. For example, you may be using GET when POST is required. Please consult the documentation. - `429`: **Too Many Requests** The BNSF API Gateway enforces rate limits to maintain application security and performance. Current rate limits are set as follows: * 1 API Request Per Second, Per Partner, Per Service * 15 API Requests Per Minute, Per Partner, Per Service * 100 API Request Per Minute, Per Service When requests exceed these limits the API Gateway will return a **429 Too Many Requests** error response. Upon receiving such exceptions, you can resubmit failed requests in a rate-limited manner, complying with the API Gateway throttle limits. - `500`: **Internal Server Error** The server encountered an unexpected condition which prevented it from fulfilling the request. This is always a problem on the server side. Our internal support systems will be made aware. - `504`: **Gateway Timeout** The server is acting as a gateway and cannot get a response in time for a request. Wait about one minute then try again. --- [API](https://skmtc.dev/bnsf/apis/bnsf-trace-api.md) - [All operations](https://skmtc.dev/bnsf/apis/bnsf-trace-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bnsf/apis/bnsf-trace-api/revisions/777129ca823f?raw)