{"openapi":"3.1.0","info":{"title":"Records for Agents: Recalls & Product Safety","description":"US federal product recall and safety data for AI agents: CPSC consumer product recalls, FDA food/drug/device enforcement actions, USDA FSIS meat/poultry/egg recalls and public health alerts, and NHTSA vehicle safety campaigns. Search by product, firm/company name, date range, or source; look up by UPC/barcode or by native recall/campaign number. Every record carries full provenance (source, source URL, fetched-at, record hash) and every response includes as_of freshness, built for agent-driven verification and compliance workflows.","version":"1.0.0","contact":{"email":"contact@recordsforagents.com"}},"servers":[{"url":"https://recalls.recordsforagents.com"}],"paths":{"/search":{"get":{"summary":"Search US federal product recalls (CPSC consumer products, FDA food/drug/device enforcement, USDA FSIS meat/poultry recalls, NHTSA vehicle campaigns) by free-text query, firm name, date range, and source.","x-402-price":"$0.01","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"firm","in":"query","required":false,"schema":{"type":"string"}},{"name":"date_from","in":"query","required":false,"schema":{"type":"string"}},{"name":"date_to","in":"query","required":false,"schema":{"type":"string"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["cpsc","fda","nhtsa","fsis"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"as_of":{"type":"string","format":"date-time"},"source":{"type":"string"},"record_count":{"type":"integer"}},"required":["data","as_of","source","record_count"]}}}},"400":{"description":"Invalid parameters","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required (x402)"}}}},"/by-firm":{"get":{"summary":"Look up US federal recalls by firm/company name (CPSC, FDA, USDA FSIS meat/poultry, and NHTSA).","x-402-price":"$0.01","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"date_from","in":"query","required":false,"schema":{"type":"string"}},{"name":"date_to","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"as_of":{"type":"string","format":"date-time"},"source":{"type":"string"},"record_count":{"type":"integer"}},"required":["data","as_of","source","record_count"]}}}},"400":{"description":"Invalid parameters","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required (x402)"}}}},"/by-upc/:upc":{"get":{"summary":"Look up recalls by UPC/barcode. Structured UPC coverage is currently CPSC-backed (partial; UPCs are sparse in federal data).","x-402-price":"$0.01","parameters":[{"name":"upc","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"as_of":{"type":"string","format":"date-time"},"source":{"type":"string"},"record_count":{"type":"integer"}},"required":["data","as_of","source","record_count"]}}}},"400":{"description":"Invalid parameters","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required (x402)"}}}},"/:recall_number":{"get":{"summary":"Fetch recall(s) by native recall number (CPSC recall number, FDA recall number e.g. F-1234-2026, NHTSA campaign number e.g. 26V329000).","x-402-price":"$0.01","parameters":[{"name":"recall_number","in":"path","required":true,"schema":{"type":"string"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["cpsc","fda","nhtsa","fsis"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"as_of":{"type":"string","format":"date-time"},"source":{"type":"string"},"record_count":{"type":"integer"}},"required":["data","as_of","source","record_count"]}}}},"400":{"description":"Invalid parameters","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required (x402)"}}}}}}