# SSA Program Operations Manual System (POMS) API

Verbatim full text of the SSA Program Operations Manual System (POMS): the
operational rulebook SSA staff use to decide retirement, disability, SSI,
and Medicare claims. SSA publishes it only as a browseable Lotus Notes
manual with no per-section index or API. This service adds one. Content is
US federal government work, public domain. No summarising or
interpretation: raw delivery only.

## When to use this

Use this when you need the complete, exact text of a specific POMS section
for a Social Security or Medicare question. Do not use it for general web
search, and do not treat it as legal advice.

## Endpoints

- GET /search?q=<keywords>&limit=<1-50>
  Free. Full-text search across all sections. Returns id, part,
  section_ref, title, effective_date, and a 200-character snippet for each
  match. Start here to find the id.

- GET /part/{code}
  Free. Part metadata (e.g. "SI", "Supplemental Security Income") and its
  full list of section ids, refs, and titles.

- GET /section/{id}
  Free. Metadata and snippet for one section.

- GET /section/{id}/full
  Paid, $0.01 USDC. Returns the full section JSON, including full_text.
  Payment uses the x402 protocol on Base mainnet (eip155:8453). Read the
  payment requirements from the 402 response, pay, and retry.

## Ids

A section id looks like "SI 01110.200" (a two-letter part code, a space,
five digits, a dot, three digits). URL-encode the space as %20. Part codes
are RM, GN, RS, DI, SI, HI, NL, QR, VB, PR, PS, SL, DX, HALLEX. Get exact
ids from /search or /part/{code}.

## Payment

- Protocol: x402
- Network: Base mainnet (eip155:8453)
- Asset: USDC
- Price: $0.01 per full section
- Facilitator: Coinbase CDP