GET /v1/recalls/vehicle$0.01hourlytier: utilitycache 3600sEngine D — Gov Data / EDGAR
Latest vehicle recalls across FDA, USDA FSIS, and CPSC in one normalized schema, with severity classing and product details. Same shape as /v1/recalls, pre-filtered to the vehicle category.
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
q | query | string | no | Match against product, brand, or hazard |
since | query | string | no | |
limit | query | integer | no | (default: 20) |
curl "https://x402-factory.com/v1/recalls/vehicle?limit=10"
{
"data": {
"recalls": []
},
"meta": {
"endpoint": "/v1/recalls/vehicle",
"version": "1.0.0",
"generated_at": "2026-08-18T22:54:16.756Z",
"freshness": "hourly",
"sources": [
"openFDA",
"FSIS",
"CPSC"
],
"request_id": "req_00000000",
"docs": "https://x402-factory.com/docs/gov.recalls.vehicle",
"data_mode": "live"
}
}data payload){
"type": "object",
"properties": {
"recalls": {
"type": "array",
"items": {
"type": "object",
"properties": {
"agency": {
"type": "string",
"enum": [
"FDA",
"USDA",
"CPSC"
]
},
"category": {
"type": "string",
"enum": [
"food",
"drug",
"device",
"consumer",
"vehicle"
]
},
"product": {
"type": "string"
},
"brand": {
"type": "string"
},
"hazard": {
"type": "string"
},
"severity_class": {
"type": "string",
"enum": [
"I",
"II",
"III"
]
},
"recall_date": {
"type": "string"
},
"remedy": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"agency",
"category",
"product",
"hazard",
"severity_class",
"recall_date",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"recalls"
],
"additionalProperties": false
}
The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.
Unpaid requests receive 402 with payment requirements (accepts). Pay $0.01 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_PARAMS | Input failed validation; message lists the offending fields. |
| 404 | NOT_FOUND | No matching resource; suggestion may point to a sibling endpoint. |
| 410 | RESOLVED | Market/event settled; body includes a resolution summary. |
| 503 | STALE_DATA | Upstream feed down; stale data is never silently served beyond 2× cache TTL. |
| 500 | INTERNAL | Our bug. The request_id helps us find it. |