# Federal Register & eCFR API

> Federal Register & eCFR API is a paid API for AI agents from api.boscolabs.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-13).

Retrieves CFR section text as in force on any date with amendment history, and Federal Register rules/notices by number or full-text search since 1994.

## Facts

- Endpoint: POST https://api.boscolabs.dev/v1/us-federal-rules?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/federal-register-ecfr-api-b44b155b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FJwoWE1R2ovlWjL_8FNxP

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 federal-register-ecfr-api-b44b155b -d '<json body>'
```

Example prompt: Can you pull the current text of 21 CFR 101.9 (nutrition labeling) as it was in force on 2024-01-01, and show me its amendment history?

## When to prefer this

Choose this endpoint when you need authoritative, point-in-time US federal regulatory text from eCFR or Federal Register documents with amendment lineage. It is the right choice for compliance research, regulatory monitoring, legal citation verification, and government contracting. It is preferable to general web search when you need structured, versioned CFR text with source links and amendment history, or when you need to retrieve specific Federal Register documents by number or agency since 1994.

## Known failure modes

- Invalid CFR citation format returns an error or empty result with no charge
- Requested date before coverage window returns empty or error
- Search query returns no matching documents — no charge on empty result
- maxTextChars too low to capture full section text — warning returned, text truncated
- Invalid document number pattern returns error — no charge
- Rate limit or upstream eCFR/FR API unavailability causes timeout

## How this service works

Federal Register and eCFR: CFR section text as in force on any date with its amendment history; Federal Register rules and notices by number or search since 1994. Typical call $0.005: $0.005 per CFR section, $0.002 per FR document, min $0.005. upto: pay only for delivered rows; exact: pays the quote (default 10 rows; set maxResults). Nothing is settled on an error or empty result. By Bosco Labs: official sources, source link per row.

## Output

Returns an array of rows, each containing: CFR section text (capped at maxTextChars), heading, citation, as-of date, unit type, amendment history with linked Federal Register documents, source URL, warnings about truncation, retrieval timestamp, and charge amount. For Federal Register searches, returns document metadata including title, type, effective date, and citation. Also includes total count, duration, and payment details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asOf": {
   "type": "string",
   "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$",
   "description": "YYYY-MM-DD"
  },
  "since": {
   "type": "string",
   "pattern": "^(\\d{4}-\\d{2}-\\d{2}(T.*)?)?$",
   "description": "YYYY-MM-DD, e.g. \"2026-11-01\""
  },
  "agency": {
   "type": "string",
   "pattern": "^[^\\[\\]{}<>\\r\\n]*$",
   "description": "Federal Register search by issuing agency: an acronym (\"BIS\", \"FDA\", \"EPA\", \"SEC\", \"OFAC\"), a name"
  },
  "search": {
   "type": "string",
   "pattern": "^[^\\[\\]{}<>\\r\\n]*$",
   "description": "Full-text search of Federal Register documents since 1994, newest first, e.g. \"entity list\""
  },
  "citation": {
   "type": "string",
   "pattern": "^\\s*$|[Ee][Cc][Ff][Rr]\\.[Gg][Oo][Vv]/|^\\s*([Tt][Ii][Tt][Ll][Ee]\\s+)?\\d{1,2}\\s*[Cc]\\.?\\s*[Ff]",
   "description": "A CFR section, part or appendix: \"21 CFR 101.9\", \"17 CFR 240.10b-5\", \"48 CFR 52.212-4\", \"15 CFR 744..."
  },
  "maxResults": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 1,
   "description": "Most rows to return: for a part citation the most recently changed units"
  },
  "documentType": {
   "enum": [
    "",
    "RULE",
    "PRORULE",
    "NOTICE",
    "PRESDOCU"
   ],
   "type": "string",
   "description": "Federal Register search by type: RULE (final rules), PRORULE (proposed rules), NOTICE or PRESDOCU"
  },
  "maxTextChars": {
   "type": "integer",
   "default": 20000,
   "maximum": 50000,
   "minimum": 1000,
   "description": "Cap on each section's text in characters, e.g. 20000 (default)"
  },
  "documentNumber": {
   "type": "string",
   "pattern": "^\\s*(([A-Za-z]\\d-)?(\\d{2}|\\d{4}|[A-Za-z]\\d)-\\d{1,6})?\\s*$",
   "description": "One Federal Register document by its number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "part": "101",
    "text": "(a) Nutrition information relating to food shall be provided for all products...",
    "as_of": "2026-11-04",
    "query": "21 CFR 101.9",
    "api_url": "https://www.ecfr.gov/api/versioner/v1/full/2026-11-04/title-21.xml?section=101.9",
    "heading": "§ 101.9 Nutrition labeling of food.",
    "removed": false,
    "section": "101.9",
    "subpart": "A",
    "citation": "21 CFR 101.9",
    "warnings": [
     "text cut at 20000 characters (of 121140); raise maxTextChars or read source_url."
    ],
    "cfr_title": 21,
    "unit_type": "section",
    "amendments": [
     {
      "date": "2023-05-24",
      "removed": false,
      "substantive": true,
      "fr_documents": [
       {
        "url": "https://www.federalregister.gov/documents/2023/05/24/2023-10602/food-labeling...",
        "type": "Rule",
        "title": "Food Labeling, Infant Formula Requirements, Food Additives and Generally Reco...",
        "citation": "88 FR 33550",
        "effective_on": "2023-05-24",
        "document_number": "2023-10602",
        "publication_date": "2023-05-24"
       }
      ]
     }
    ],
    "source_url": "https://www.ecfr.gov/on/2026-11-04/title-21/section-101.9",
    "text_chars": 19521,
    "provided_by": "Bosco Labs (boscolabs.dev)",
    "record_type": "cfr_section",
    "source_note": "[58 FR 2175, Jan. 6, 1993]",
    "retrieved_at": "2026-11-06T08:37:27+00:00",
    "changed_since": null,
    "cfr_title_name": "Food and Drugs",
    "schema_version": "1",
    "text_truncated": true,
    "duration_seconds": 1.62,
    "latest_change_date": "2023-05-24",
    "ecfr_up_to_date_as_of": "2026-11-04"
   }
  ],
  "tool": "us-federal-rules",
  "count": 1,
  "message": "",
  "paid_via": "x402",
  "warnings": [],
  "balance_usd": 0,
  "charged_usd": 0.005,
  "duration_seconds": 1.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/federal-register-ecfr-api-b44b155b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boscolabs.dev](https://www.zero.xyz/host/api.boscolabs.dev/llms.txt)
