{"openapi":"3.1.0","info":{"title":"Records for Agents API","description":"Verification and compliance records for AI agents, paid per-request via x402 (USDC on Base).","version":"1.0.0","contact":{"email":"contact@recordsforagents.com"}},"servers":[{"url":"https://recordsforagents.com"}],"paths":{"/hello":{"get":{"summary":"x402 hello world: returns a greeting with provenance fields. Verification and compliance records endpoints are mounted from real niches (see /recalls/*).","x-402-price":"$0.001","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)"}}}},"/recalls/search":{"get":{"summary":"Search US federal product recalls (CPSC consumer products, FDA food/drug/device enforcement, NHTSA vehicle campaigns, and USDA FSIS meat/poultry recalls through 2026-10-22) 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)"}}}},"/recalls/by-firm":{"get":{"summary":"Look up US federal recalls by firm/company name (CPSC, FDA, and NHTSA, plus USDA FSIS meat/poultry through 2026-10-22).","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)"}}}},"/recalls/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)"}}}},"/recalls/: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)"}}}},"/licenses/search":{"get":{"summary":"Search contractor/trade licenses (TX TDLR electricians/A-C, FL DBPR construction) by free-text query, name, state, profession, or status.","x-402-price":"$0.01","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["tx","fl","or","de","va"]}},{"name":"profession","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","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)"}}}},"/licenses/by-number/:license_number":{"get":{"summary":"Look up license record(s) by native license number, optionally scoped to a state.","x-402-price":"$0.01","parameters":[{"name":"license_number","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["tx","fl","or","de","va"]}}],"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)"}}}},"/licenses/verify":{"get":{"summary":"Fuzzy-verify a business or person name against the license roster; returns scored candidate matches (name variants, legal-suffix/dba handling) with their license history.","x-402-price":"$0.01","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["tx","fl","or","de","va"]}},{"name":"min_score","in":"query","required":false,"schema":{"type":"number"}}],"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)"}}}},"/licenses/disciplinary":{"get":{"summary":"Look up TDLR board disciplinary/administrative orders by respondent name, license number, or date range.","x-402-price":"$0.01","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"license_number","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":"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)"}}}},"/entities/screen":{"get":{"summary":"Screen a name against US government restricted-party lists: OFAC sanctions (SDN and the non-SDN lists), plus the Commerce and State watchlists (BIS Entity List, Denied Persons, Unverified, Military End User; State ITAR Debarred and Nonproliferation Sanctions), all from the Trade.gov Consolidated Screening List, including a match against known aliases. Returns scored candidate matches with the matched name variant, the specific list the hit came from, the OFAC ent_num where there is one, and program codes.","x-402-price":"$0.02","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["business","person"]}},{"name":"min_score","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","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)"}}}},"/entities/search":{"get":{"summary":"Full-text search across OFAC, BIS and State restricted-party records (Trade.gov Consolidated Screening List) by free-text query, optionally scoped to a jurisdiction or status.","x-402-price":"$0.01","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string","enum":["ofac"]}},{"name":"status","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)"}}}},"/entities/by-number/:jurisdiction/:number":{"get":{"summary":"Exact lookup by OFAC ent_num (from the Trade.gov Consolidated Screening List), scoped by jurisdiction. An entity on more than one OFAC list returns one record per list.","x-402-price":"$0.01","parameters":[{"name":"jurisdiction","in":"path","required":true,"schema":{"type":"string","enum":["ofac"]}},{"name":"number","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)"}}}}}}