# SSA POMS API

The operational rulebook SSA staff use to decide retirement, disability, SSI, and Medicare claims.

The Program Operations Manual System is the Social Security Administration's primary operational reference. SSA publishes it only as a browseable Lotus Notes manual with no per-section index and no API. This service adds keyword search and per-section retrieval over a structured database.

- Coverage: 16,415 sections across 14 parts
- Source: Social Security Administration — public-domain US government work
- API root: https://poms-api.canvas-cart.workers.dev
- Machine guide: https://poms-api.canvas-cart.workers.dev/llms.txt
- Record ids: a section id with a space, e.g. "DI 33001.001" or "SI 01110.200"; URL-encode the space as %20; get it from /search or /part/{code}

## Routes

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

## Free search example

https://poms-api.canvas-cart.workers.dev/search?q=substantial+gainful+activity&limit=3

## Paid call

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

Sample paid URL: https://poms-api.canvas-cart.workers.dev/section/DI%2033001.001/full