# BNM Data Shop – APHIS AIR Confirmation Letters

> BNM Data Shop – APHIS AIR Confirmation Letters is a paid API for AI agents from ticks.bnm.farm, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns USDA APHIS Biotechnology Regulatory Services air-letter confirmation letter records as structured JSON

## Facts

- Endpoint: GET https://ticks.bnm.farm/air-letters
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bnm-data-shop-aphis-air-confirmation-letters-ead2341f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7gFE_5gzmGtSaaYAFtXra

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bnm-data-shop-aphis-air-confirmation-letters-ead2341f
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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)

## How this service works

Official public data as JSON. Unpaid paid routes return HTTP 402.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bnm-data-shop-aphis-air-confirmation-letters-ead2341f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ticks.bnm.farm](https://www.zero.xyz/host/ticks.bnm.farm/llms.txt)