# US Federal Register API
> The US Federal Register as an API — the official daily journal of the United States government, live from federalregister.gov. Search the full record of federal rules, proposed rules, public notices and presidential documents (including executive orders) by keyword, document type, issuing agency and publication-date range; fetch any document by its number with title, abstract, agencies, publication and signing dates, executive-order number and links to the official HTML and PDF; and list the 470+ federal agencies. Ideal for legal-tech, compliance, regulatory-monitoring, government-transparency, policy-research and news applications. Public-domain US government data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fedregister-api/..."
```

## Pricing
- **Free** (Free) — 3,600 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 49,000 calls/Mo, 8 req/s
- **Pro** ($15/Mo) — 255,000 calls/Mo, 20 req/s
- **Mega** ($38/Mo) — 1,230,000 calls/Mo, 50 req/s

## Endpoints

### Federal Register

#### `GET /v1/agencies` — Federal agencies

**Parameters:**
- `q` (query, optional, string) — Filter agencies by name Example: `energy`
- `limit` (query, optional, string) — Max results (1-700, default 100) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fedregister-api/v1/agencies?q=energy&limit=100"
```

**Response:**
```json
{
    "data": {
        "count": 12,
        "total": 12,
        "agencies": [
            {
                "id": 620,
                "url": "https://www.federalregister.gov/agencies/energy-and-environmental-policy-office",
                "name": "Energy and Environmental Policy Office",
                "slug": "energy-and-environmental-policy-office",
                "parent_id": 12,
                "short_name": "OEEP"
            },
            {
                "id": 136,
                "url": "https://www.federalregister.gov/agencies/energy-department",
                "name": "Energy Department",
                "slug": "energy-department",
                "parent_id": null,
                "short_name": "DOE"
            },
            {
                "id": 137,
                "url": "https://www.federalregister.gov/agencies/energy-efficiency-and-renewable-energy-office",
                "name": "Energy Efficiency and Renewable Energy Office",
                "slug": "energy-efficiency-and-renewable-energy-office",
                "parent_id": 136,
                "short_name": "DOE"
            },
            {
                "id": 138,
                "url": "https://www.federalregister.gov/agencies/energy-information-administration",
                "name": "Energy Information Administration",
                "slug": "energy-information-administration",
                "parent_id": 136,
                "short_name": "EIA"
            },
            {
      
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/document` — One document by its number

**Parameters:**
- `number` (query, required, string) — Federal Register document number, e.g. 2021-02177 (Executive Order 14008) Example: `2021-02177`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fedregister-api/v1/document?number=2021-02177"
```

**Response:**
```json
{
    "data": {
        "document": {
            "type": "Presidential Document",
            "title": "Tackling the Climate Crisis at Home and Abroad",
            "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2021-02-01/pdf/2021-02177.pdf",
            "abstract": null,
            "agencies": [
                "Executive Office of the President"
            ],
            "html_url": "https://www.federalregister.gov/documents/2021/02/01/2021-02177/tackling-the-climate-crisis-at-home-and-abroad",
            "president": "Joseph R. Biden Jr.",
            "signing_date": "2021-01-27",
            "document_number": "2021-02177",
            "publication_date": "2021-02-01",
            "executive_order_number": "14008"
        }
    },
    "meta": {
        "timestamp": "2026-05-31T07:56:11.210Z",
        "request_id": "449880a6-6eb3-4820-ac10-7e3a0e9511af"
    },
    "status": "ok",
    "message": "Document retrieved",
    "success": true
}
```

#### `GET /v1/search` — Search Federal Register documents

**Parameters:**
- `term` (query, optional, string) — Full-text search term Example: `energy`
- `type` (query, optional, string) — rule | proposed | notice | presidential
- `agency` (query, optional, string) — Agency slug, e.g. energy-department
- `date_from` (query, optional, string) — Published on or after (YYYY-MM-DD)
- `date_to` (query, optional, string) — Published on or before (YYYY-MM-DD)
- `order` (query, optional, string) — newest | oldest | relevance
- `per_page` (query, optional, string) — Results per page (1-100, default 20) Example: `20`
- `page` (query, optional, string) — Page number Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fedregister-api/v1/search?term=energy&per_page=20&page=1"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 20,
        "total": 10000,
        "results": [
            {
                "type": "Notice",
                "title": "Arms Sales Notification",
                "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-06-01/pdf/2026-10946.pdf",
                "abstract": "The Department of War (DoW) is publishing the unclassified text of an arms sales notification.",
                "agencies": [
                    "Defense Department",
                    "Office of the Secretary"
                ],
                "html_url": "https://www.federalregister.gov/documents/2026/06/01/2026-10946/arms-sales-notification",
                "president": "Donald Trump",
                "signing_date": null,
                "document_number": "2026-10946",
                "publication_date": "2026-06-01",
                "executive_order_number": null
            },
            {
                "type": "Notice",
                "title": "Arms Sales Notification",
                "pdf_url": "https://www.govinfo.gov/content/pkg/FR-2026-06-01/pdf/2026-10937.pdf",
                "abstract": "The Department of War (DoW) is publishing the unclassified text of an arms sales notification.",
                "agencies": [
                    "Defense Department",
                    "Office of the Secretary"
                ],
                "html_url": "https://www.federalregister.gov/documents/2026/06/01/2026-10937/arms-sales-notifica
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & document types

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fedregister-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Live US government regulations, notices and presidential documents from the official Federal Register. Search by term, type, agency slug and publication-date range; fetch a document by its number; list federal agencies.",
        "source": "US Federal Register (federalregister.gov)",
        "endpoints": [
            "/v1/search",
            "/v1/document",
            "/v1/agencies",
            "/v1/meta"
        ],
        "document_types": {
            "rule": "Final rule",
            "notice": "Notice",
            "proposed": "Proposed rule (PRORULE)",
            "presidential": "Presidential document / executive order (PRESDOCU)"
        }
    },
    "meta": {
        "timestamp": "2026-05-31T07:56:11.596Z",
        "request_id": "fdbba875-8dc6-4914-9e46-0104adc16388"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/fedregister-api
OpenAPI spec: https://www.oanor.com/api/fedregister-api/openapi.json