# IRS Internal Revenue Bulletin API

Verbatim IRS Revenue Rulings, Revenue Procedures, Notices, and Treasury Decisions since 2003.

The Internal Revenue Bulletin is the IRS's authoritative weekly publication of official guidance. This API serves every document from the 2003-onward HTML era, verbatim, from a structured database. The IRS publishes these only as 1,200+ separate bulletin pages with no per-document search and no per-document retrieval.

- Coverage: 6,363 documents across 1,206 bulletin issues
- Source: Internal Revenue Service — public-domain US government work
- API root: https://irb-precedent-api.canvas-cart.workers.dev
- Machine guide: https://irb-precedent-api.canvas-cart.workers.dev/llms.txt
- Record ids: a document slug, e.g. "rev-rul-2003-71" or "td-2003-9091"; get it from /search

## Routes

- `GET /search?q=<keywords>&limit=<1-50>` — free
- `GET /doc/{id}` — free
- `GET /doc/{id}/full` — paid ($0.01)

## Free search example

https://irb-precedent-api.canvas-cart.workers.dev/search?q=research+credit&limit=3

## Paid call

Request `/doc/{id}/full`. Expect `402 Payment Required` with price $0.01 per document, network eip155:8453, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC), payout 0xA40Dadc75B69bEe8325E8089258235213293F8F4. Pay, repeat, receive the record.

Sample paid URL: https://irb-precedent-api.canvas-cart.workers.dev/doc/td-2003-9091/full