{"uid":"cap_7gFE_5gzmGtSaaYAFtXra","slug":"bnm-data-shop-aphis-air-confirmation-letters-ead2341f","name":"BNM Data Shop – APHIS AIR Confirmation Letters","description":"Official public data as JSON. Unpaid paid routes return HTTP 402.","url":"https://ticks.bnm.farm/air-letters","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"schema":{"type":"object"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"asOf":"2026-06-22","cards":[{"id":"26-173-01air","body":"United States Department of Agriculture\nAnimal and Plant Health Inspection Service\nBiotechnology Regulatory Services\nRe: Confirmation of the regulatory status\n26-173-01air\n7 CFR part 340","date":"2026-06-22","docket":"26-173-01air","sourceUrl":"https://direct.aphis.usda.gov/sites/default/files/26-173-01air-response.pdf","institution":"KAGOME Co., LTD."}],"source":"https://www.aphis.usda.gov/confirmation-letters","status":"ok","product":"aphis-air-confirmation-letter-bodies","records":[{"id":"26-173-01air","url":"https://direct.aphis.usda.gov/sites/default/files/26-173-01air-response.pdf","date":"2026-06-22","firm":"KAGOME Co., LTD.","type":"air-letter"}],"fetchedAt":"2026-08-23T12:00:00.000Z","recordCount":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kLq0gAGQg96vaxwa9rkRn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns USDA APHIS Biotechnology Regulatory Services air-letter confirmation letter records as structured JSON","exampleAgentPrompt":"Pull the latest APHIS Biotechnology Regulatory Services air-letter confirmation letters from BNM Data Shop and show me the docket IDs, firm names, and dates.","exampleUseCases":[{"title":"Track new biotech regulatory confirmations","prompt":"Check the APHIS air-letter confirmation records and tell me which firms received new regulatory status confirmations this week, with their docket numbers."},{"title":"Compliance research for biotech submission","prompt":"I need the full list of APHIS BRS air-letter confirmations for 7 CFR part 340 — can you fetch the latest records from BNM and give me each institution name and source PDF link?"},{"title":"Monitor USDA biotech docket activity","prompt":"Fetch today's APHIS air-letter confirmation letter data and let me know if there are any new docket entries I haven't seen before — include the date and docket ID for each."}],"resultDescription":"A JSON object with an 'ok' status flag, an 'asOf' date, a list of card objects (each with id, body text, date, docket, sourceUrl, institution), a records array (id, url, date, firm, type), the data source URL, product name, fetchedAt timestamp, and a recordCount integer.","failureModes":["HTTP 402 if payment is not included — endpoint requires $0.05 USDC per call via x402 protocol","Empty records array if no air letters have been issued recently","Network timeout if APHIS upstream source is temporarily unavailable","Stale data if upstream APHIS source has not been refreshed recently (check fetchedAt field)"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable JSON of USDA APHIS Biotechnology Regulatory Services air-letter confirmation letters without scraping the APHIS website directly. Prefer it over manual PDF retrieval or web scraping when you need normalized records with docket IDs, firm names, dates, and body text in a single API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:10.284Z","isFirstParty":false}