Vehicle Recalls API

Retrieve Vehicle Recall information using a VIN.

The Vehicle Recalls API provides access to recall data by allowing users to search for safety recalls based on a vehicle's VIN. This API is useful for developers who need to access recall information for a specific vehicle.

This endpoint allows you to retrieve vehicle recall information using a VIN.

Required attributes

Name
key
Type
string
Description
Your CarsXE API key.
Name
vin
Type
string
Description
The 17 character long vehicle identification number.

Response attributes

Name
success
Type
boolean
Description
Whether the vehicle data has been retrieved successfully.
Name
query
Type
object
Description
Object detailing the query you made, including the API key and VIN.
Name
data
Type
object
Description
Object containing vehicle details, recall information, and related metadata.
Name
uuid
Type
string
Description
Unique identifier for the vehicle record.
Name
vin
Type
string
Description
The Vehicle Identification Number (VIN) of the queried vehicle.
Name
manufacturer
Type
string
Description
The name of the vehicle manufacturer.
Name
model_year
Type
string
Description
The model year of the vehicle.
Name
make
Type
string
Description
The make (brand) of the vehicle.
Name
model
Type
string
Description
The model name of the vehicle.
Name
has_recalls
Type
boolean
Description
Indicates whether there are any recalls associated with the vehicle.
Name
recall_count
Type
string
Description
Number of recalls associated with the vehicle.
Name
recalls
Type
array
Description
A list of recall objects, each containing detailed recall information.
Name
recall_date
Type
string
Description
The date the recall was issued.
Name
expiration_date
Type
string
Description
The expiration date of the recall, if applicable.
Name
nhtsa_id
Type
string
Description
The recall ID assigned by NHTSA (National Highway Traffic Safety Administration).
Name
manufacturer_id
Type
string
Description
The recall ID assigned by the manufacturer.
Name
recall_campaign_type
Type
string
Description
The type of recall campaign (e.g., NHTSA, manufacturer-initiated).
Name
recall_name
Type
string
Description
The name or title of the recall campaign.
Name
component
Type
string
Description
The vehicle component affected by the recall.
Name
recall_description
Type
string
Description
A short description of the recall.
Name
risk_description
Type
string
Description
A detailed explanation of the risks associated with the recall.
Name
stop_sale
Type
boolean
Description
Indicates whether the recall includes a stop-sale order.
Name
dont_drive
Type
boolean
Description
Indicates whether the recall includes a "do not drive" advisory.
Name
remedy_available
Type
boolean
Description
Indicates whether a remedy for the recall is available.
Name
recall_remedy
Type
string
Description
Description of the manufacturer’s remedy for the recall.
Name
parts_available
Type
boolean
Description
Indicates whether the necessary parts for the recall remedy are available.
Name
labor_hours_min
Type
string
Description
Minimum estimated labor hours for the recall repair.
Name
labor_hours_max
Type
string
Description
Maximum estimated labor hours for the recall repair.
Name
recall_status
Type
string
Description
The current status of the recall (e.g., Incomplete, Completed).
Name
timestamp
Type
string
Description
The timestamp of the API response.

Frequently asked questions

Request

GET

/recalls

curl -G https://api.carsxe.com/v1/recalls \
  -d key=CARSXE_API_KEY \
  -d vin=1C4JJXR64PW696340

Response

{
  "success": true,
  "input": {
    "key": "API_KEY",
    "vin": "1C4JJXR64PW696340"
  },
  "data": {
    "uuid": "c5325edd-6239-4d4c-84fc-f189c886e4c3",
    "vin": "1C4JJXR64PW696340",
    "manufacturer": "FCA US LLC",
    "model_year": "2023",
    "make": "JEEP",
    "model": "Wrangler",
    "has_recalls": true,
    "recall_count": 1,
    "recalls": [
      {
        "recall_date": "2024-09-27",
        "expiration_date": null,
        "nhtsa_id": "24V720",
        "manufacturer_id": "95B",
        "recall_campaign_type": "NHTSA",
        "recall_name": "2020-2024 JL & 2022-2024 WL PHEV High Voltage Battery",
        "component": "",
        "recall_description": "2020-2024 JL & 2022-2024 WL PHEV High Voltage Battery",
        "risk_description": "In rare circumstances, a battery pack may contain cells with separator damage. Separator damage, combined with other complex interactions within the cells, may lead to a vehicle fire. A vehicle fire can result in increased risk of occupant injury and/or injury to persons outside the vehicle, as well as property damage.",
        "stop_sale": null,
        "dont_drive": null,
        "remedy_available": null,
        "recall_remedy": "FCA US will conduct a voluntary safety recall on all affected vehicles. Remedy is a software flash followed by a HV battery replacement if needed.",
        "parts_available": null,
        "labor_hours_min": null,
        "labor_hours_max": null,
        "recall_status": "Incomplete"
      }
    ]
  },
  "timestamp": "2025-03-04T23:03:38.406Z"
}

International VIN Decoder Plate Decoder