watchers

WATCHER: get a signed callback when a new US Federal...

WATCHER: get a signed callback when a new US Federal Register document is published. Arm once, pay once. Optionally filter by type (RULE / PRORULE / NOTICE / PRESDOCU), agency (slug, e.g. environmental-protection-agency), and/or keyword in the title. Fires once per new document (deduped by document number); bounded by maxFires/expiry. Existing docs at arm time are baselined. Free public-domain data. Signed + retried; recoverable via watchers.status. Returns a watcherId.

post/api/watchers/federal-register

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/watchers/federal-register
  • Auth: API key in header PAYMENT-SIGNATURE

Request body

type'RULE' | 'PRORULE' | 'NOTICE' | 'PRESDOCU'

Document type filter. Omit for all.

agencystring

Agency slug, e.g. federal-trade-commission.

keywordstring

Optional: only fire on titles containing this text (case-insensitive).

callbackUrlstring uri required

Signed event POSTed here (verify X-2s-Signature). Any http(s) URL.

payloadobject

Arbitrary JSON echoed back in every callback.

expiresInSecondsinteger

Active window in seconds (default 30d, max 90d).

maxFiresinteger

Stop after this many documents (default 25).

labelstring

Optional free-text tag.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.