Recalls

live

TC+NHTSA fused, ref-keyed compliance

GET/v2/recalls/vin/{vin}

The compliance check: recalls affecting a VIN

The authoritative is-this-vehicle-under-recall check — Transport Canada + NHTSA fused, ref-keyed.

Path parameters

ParameterType
curl "https://api.cardog.app/v2/recalls/vin/1HGCM82633A123456" \
  -H "x-api-key: $CARDOG_API_KEY"

Response 200 — RecallsVin

FieldType

Example response

8 keys
"response": {
"vin": "1FTFW1E84PKE12345",
"modelYearRef": "model-year:ford/f-150/2023",
"resolved": true,
"source": "decoded",
"total": 30,
"recalls": [
0: {13 items},
1: {13 items},
2: {13 items},
3: {13 items},
4: {13 items},
5: {13 items},
6: {13 items},
7: {13 items},
8: {13 items},
9: {13 items},
10: {13 items},
11: {13 items},
12: {13 items},
13: {13 items},
14: {13 items},
15: {13 items},
16: {13 items},
17: {13 items},
18: {13 items},
19: {13 items},
20: {13 items},
21: {13 items},
22: {13 items},
23: {13 items},
24: {13 items},
25: {13 items},
26: {13 items},
27: {13 items},
28: {13 items},
29: {13 items}
],
"asOf": "2026-07-31T06:03:14.613Z",
"links": {
"identity": "/v2/vin/1FTFW1E84PKE12345",
"entity": "/v2/recalls/entity/model-year%3Aford%2Ff-150%2F2023"
}
}

Errors — every non-2xx body is the error envelope: 400, 401, 402, 429, 500

GET/v2/recalls/entity/{ref}

Recalls scoped to a make:, model:, or model-year: ref

Path parameters

ParameterType

Query parameters

ParameterType
curl "https://api.cardog.app/v2/recalls/entity/make:toyota" \
  -H "x-api-key: $CARDOG_API_KEY"

Response 200 — RecallsEntity

FieldType

Example response

4 keys
"response": {
"ref": "make:toyota",
"total": 758,
"recalls": [
0: {13 items},
1: {13 items},
2: {13 items},
3: {13 items},
4: {13 items}
],
"links": {
"entity": "/v2/entities/make%3Atoyota"
}
}

Errors — every non-2xx body is the error envelope: 400, 401, 402, 429, 500

GET/v2/recalls/feed

Latest campaigns, newest first

Query parameters

ParameterType
curl "https://api.cardog.app/v2/recalls/feed" \
  -H "x-api-key: $CARDOG_API_KEY"

Response 200 — RecallsFeed

FieldType

Example response

2 keys
"response": {
"recalls": [
0: {13 items},
1: {13 items},
2: {13 items},
3: {13 items},
4: {13 items},
5: {13 items},
6: {13 items},
7: {13 items},
8: {13 items},
9: {13 items}
],
"links": {
"stats": "/v2/recalls/stats"
}
}

Errors — every non-2xx body is the error envelope: 401, 429, 500

GET/v2/recalls/stats

Recall dataset counts (campaigns, affected model-year links, freshness)

curl "https://api.cardog.app/v2/recalls/stats" \
  -H "x-api-key: $CARDOG_API_KEY"

Response 200 — RecallsStats

FieldType

Example response

3 keys
"response": {
"campaigns": 48102,
"links": 283560,
"latest": "2026-07-28"
}

Errors — every non-2xx body is the error envelope: 401, 429, 500

GET/v2/recalls/{ref}

One campaign by recall ref

Path parameters

ParameterType
curl "https://api.cardog.app/v2/recalls/recall:tc%2F2024-123" \
  -H "x-api-key: $CARDOG_API_KEY"

Response 200 — Recall

FieldType

Example response

13 keys
"response": {
"ref": "recall:nhtsa/26v490000",
"authority": "nhtsa",
"authorityLabel": "NHTSA",
"campaignNumber": "26V490000",
"component": "EQUIPMENT:RECREATIONAL VEHICLE/TRAILER:120/240 VAC ELECTRICAL SYSTEM:RECEPTACLE",
"defectSummary": "Grand Design RV, LLC (Grand Design) is recalling certain 2026 Imagine travel trailers. The outlet cover may have been improperly secured, allowing screws to contact wiring.",
"consequenceSummary": "Contact with wiring may cause a short circuit or an electrical arc, increasing the risk of a fire.",
"correctiveAction": "Dealers will inspect and repair the screws as necessary, free of charge. Owner notification letter are expected to be mailed August 17, 2026. Owners may contact Grand Design customer service at 1-574-825-9679. Grand Design's number for this recall is 910064.",
"recallDate": "2026-07-28",
"notificationType": null,
"unitsAffected": 2,
"affects": [
0: {3 items}
],
"links": {
"self": "/v2/recalls/recall%3Anhtsa%2F26v490000"
}
}

Errors — every non-2xx body is the error envelope: 400, 401, 404, 429, 500

Generated from the contract. Machine-readable spec: GET https://api.cardog.app/v2/openapi.json · markdown twin: /docs/reference/recalls.md