# Federal Comment Periods (`federal-register.comment_periods`)

Open public comment periods on federal rules, proposed rules and notices, with their deadlines, filtered by agency, keyword, type and closing window, soonest deadline first.

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

- Endpoint: `POST https://api.primaryapi.com/v1/run/federal-register.comment_periods`
- 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.comment_periods`
- 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. "emissions". Omit for every open comment period. |
| `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 3 items | Only these document types (rule, proposed_rule, notice). Omit for all three. |
| `closingFrom` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only comment periods closing on or after this date (YYYY-MM-DD). Default: today (UTC), i.e. still open. |
| `closingTo` | string | no |  | pattern: ^\d{4}-(0[1-9]\|1[0-2])-(0[1-9]\|[12]\d\|3[01])$ | Only comment periods closing on or before this date (YYYY-MM-DD), e.g. to see deadlines in the next 30 days. |
| `limit` | integer | no | 25 | 1–100 | Maximum number of results to return (1-100, default 25). |
| `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 |
|---|---|---|
| `commentPeriods` | object[] | Soonest deadline first, then document number (ascending) |
| `commentPeriods[].documentNumber` | string \| null | Federal Register document number, when the document has one |
| `commentPeriods[].regulationsGovId` | string \| null | Document id on the federal comment portal, when known |
| `commentPeriods[].docketId` | string \| null | Agency docket id, e.g. "EPA-HQ-OPPT-2020-0549" |
| `commentPeriods[].title` | string |  |
| `commentPeriods[].type` | enum |  |
| `commentPeriods[].agencies` | string[] | Agency names (or acronyms when only those are known) |
| `commentPeriods[].publicationDate` | string \| null | YYYY-MM-DD |
| `commentPeriods[].commentsCloseOn` | string | Comment deadline, YYYY-MM-DD (US Eastern calendar day) |
| `commentPeriods[].url` | string | Document page |
| `commentPeriods[].commentUrl` | string \| null | Where to submit a comment |
| `totalCount` | integer | Comment periods matching the filters |
| `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.comment_periods" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agency":"EPA","limit":1}'
```

## 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": {
      "commentPeriods": [
        {
          "documentNumber": "2026-19027",
          "regulationsGovId": "EPA-HQ-OLEM-2026-4326-0001",
          "docketId": "EPA-HQ-OLEM-2026-4326",
          "title": "Indiana: Approval of State Coal Combustion Residuals Permit Program",
          "type": "proposed_rule",
          "agencies": [
            "Environmental Protection Agency"
          ],
          "publicationDate": "2026-09-16",
          "commentsCloseOn": "2026-11-16",
          "url": "https://www.federalregister.gov/documents/2026/09/16/2026-19027/indiana-approval-of-state-coal-combustion-residuals-permit-program",
          "commentUrl": "https://www.regulations.gov/commenton/EPA-HQ-OLEM-2026-4326-0001"
        }
      ],
      "totalCount": 37,
      "nextCursor": "eyJvIjoxfQ"
    }
  },
  "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.comment_periods`

## 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: every comment period still open today (UTC), i.e. closing today or later. A period drops out of the list once its deadline has passed, which a monitor reports as a change. An empty result 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. Deadlines are as published; agencies can extend or reopen a comment period, so confirm on the docket before relying on a date.

