# Federal Register Documents (`federal-register.documents`)

New federal rules, proposed rules, notices and presidential documents from the Federal Register, filtered by agency, keyword, type, docket and publication window, newest first.

Docs: https://primaryapi.com/docs/api-reference/federal-register/documents

- Endpoint: `POST https://api.primaryapi.com/v1/run/federal-register.documents`
- Category: Compliance & Records · Platform: `federal-register` · Kind: list · Status: live
- Price: 1 credit per call. Every call costs the same, including calls that were retried automatically.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=federal-register.documents`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `query` | string | no |  | max 200 chars | Full-text search terms, e.g. "PFAS" or "\"climate disclosure\"" (quote a phrase). Omit for every document. |
| `agency` | string | no |  | max 120 chars | Agency as an acronym ("EPA", "SEC", "FDA"), its full name ("Environmental Protection Agency") or its Federal Register slug ("environmental-protection-agency"). Parent agencies include their sub-agencies. |
| `types` | enum[] | no |  | min 1 items; max 4 items | Only these document types (rule, proposed_rule, notice, presidential_document). Omit for all. |
| `docketId` | string | no |  | max 80 chars | Only documents filed under this agency docket, e.g. "EPA-HQ-OPPT-2020-0549". |
| `significant` | boolean | no |  |  | true = only documents deemed significant under Executive Order 12866. |
| `dateFrom` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only items published on or after this date (YYYY-MM-DD). Default: 30 days before dateTo. The window may span at most 366 days. |
| `dateTo` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only items published on or before this date (YYYY-MM-DD). Default: today (UTC). |
| `limit` | integer | no | 20 | 1–100 | Maximum number of results to return (1-100, default 20). |
| `cursor` | string | no |  |  | Opaque pagination cursor: pass the previous response's nextCursor. |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `documents` | object[] | Newest publication date first, then document number (descending) |
| `documents[].documentNumber` | string | Federal Register document number, e.g. "2026-23125" |
| `documents[].title` | string |  |
| `documents[].type` | enum |  |
| `documents[].action` | string \| null | e.g. "Proposed rule; request for comments." |
| `documents[].abstract` | string \| null |  |
| `documents[].agencies` | object[] |  |
| `documents[].agencies[].name` | string |  |
| `documents[].agencies[].slug` | string \| null | Federal Register agency slug, e.g. "environmental-protection-agency" |
| `documents[].publicationDate` | string | YYYY-MM-DD |
| `documents[].effectiveOn` | string \| null | Rules: effective date, YYYY-MM-DD |
| `documents[].commentsCloseOn` | string \| null | Comment deadline, YYYY-MM-DD, when comments are invited |
| `documents[].docketIds` | string[] |  |
| `documents[].regulationIdNumbers` | string[] | RINs, e.g. "2070-AK67" |
| `documents[].regulationsGovId` | string \| null | Document id on the federal comment portal, when linked |
| `documents[].citation` | string \| null | e.g. "91 FR 73228" |
| `documents[].significant` | boolean \| null | Deemed significant under EO 12866 (when known) |
| `documents[].url` | string | Document page on federalregister.gov |
| `documents[].pdfUrl` | string \| null | Official PDF on govinfo.gov |
| `documents[].commentUrl` | string \| null | Where to submit a comment, when open |
| `totalCount` | integer | Documents matching the filters in the window |
| `nextCursor` | string \| null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

Pagination: pass the previous response’s `nextCursor` as `cursor` to get the next page; `nextCursor: null` means there are no more results.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/federal-register.documents" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agency":"SEC","types":["rule"],"dateFrom":"2026-09-01","dateTo":"2026-11-15","limit":1,"cursor":"eyJwIjoyfQ"}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "documents": [
        {
          "documentNumber": "2026-20461",
          "title": "Adoption of Updated EDGAR Filer Manual",
          "type": "rule",
          "action": "Final rule.",
          "abstract": "The Securities and Exchange Commission (\"Commission\") is adopting amendments to Volume II of the Electronic Data Gathering, Analysis, and Retrieval system Filer Manual (\"EDGAR Filer Manual\" or \"Filer Manual\") and related rules and forms. EDGAR Release 26.3 will be deployed in the EDGAR system on September 14, 2026.",
          "agencies": [
            {
              "name": "Securities and Exchange Commission",
              "slug": "securities-and-exchange-commission"
            }
          ],
          "publicationDate": "2026-10-06",
          "effectiveOn": "2026-10-06",
          "commentsCloseOn": null,
          "docketIds": [
            "Release Nos. 33-11438",
            "34-106345",
            "39-2565",
            "IC-36326"
          ],
          "regulationIdNumbers": [],
          "regulationsGovId": "SEC-2026-6213-0001",
          "citation": "91 FR 63476",
          "significant": null,
          "url": "https://www.federalregister.gov/documents/2026/10/06/2026-20461/adoption-of-updated-edgar-filer-manual",
          "pdfUrl": "https://www.govinfo.gov/content/pkg/FR-2026-10-06/pdf/2026-20461.pdf",
          "commentUrl": null
        }
      ],
      "totalCount": 4,
      "nextCursor": "eyJwIjozfQ"
    }
  },
  "provider": "PrimaryAPI",
  "credits": 1,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
  "nextCursor": null
}
```

## Pricing and reliability

- Usual price: 1 credit per call
- Price ceiling: the usual price, even when a call is retried. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=federal-register.documents`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Default window: the 30 days up to today (UTC), at most 366 days, by publication date. Documents appear on the morning of their publication day (public inspection copies earlier are not included). Paging reaches the first 50 pages of a query; narrow the window for more. totalCount is the upstream count for the filters. An empty window is a free miss.

## Legal

US government public records, returned as published by the agency; check the official source before relying on a record. Not legal advice. federalregister.gov is not the official legal edition of the Federal Register; the official edition is the PDF on govinfo.gov (pdfUrl).

