Log in Get a free API key
Developer docs · free tier · private beta

Payer rules you can prove.

Medicare DME today. All of Medicare and Medicaid next.

The developer front door for the Verzi Health API. Every answer comes with a receipt: the verbatim CMS source, its version, and the date of service. Live for Medicare DME. Date-of-service LCD and policy article text, verbatim from CMS. Versions back to October 2015.

curl · no key needed for the archive
# Which version of LCD L33718 was in force on a date of service? $ curl "https://api.verzi.health/v1/archive/docs/lcd:33718/as-of?date=2024-01-15" # Every version of that LCD, with its dates (also public) $ curl "https://api.verzi.health/v1/archive/docs/lcd:33718/versions"

Why developers build on Verzi

The API your team was about to build internally, plus the one thing nobody builds twice: a hash-pinned history of what the rules said on a date.

Signed, with a receipt

A signed answer covers one claim line as of its date of service: provider standing, coding edits, and the fee cell, each with a replayable receipt, plus labeled documentation requirements, quoted from the policy in force that day. A small set of labels for E0601, K0001 and E1390 is approved by Verzi Health staff; coder review is in progress. When a label has passed a double check by two independent automated reviews, a receipt can show it separately and clearly marked, as not yet reviewed by a coder. Each policy is only partly labeled, and the receipt says which documents are not labeled yet. See how a signed answer works.

fact + source + version + sha256

The source archive

Archived versions of LCDs, articles, and coverage documents back to October 2015, where CMS kept them.

vs. "the rule changed, we lost the old one"

Provenance you can audit

Every claim cites its source. /sources lists every dataset with license and refresh history. Every signed answer and every archive answer carries the source document, version, and sha256.

vs. methodology black boxes

Not PHI, no BAA required

All data is provider-, facility-, or population-level, from public primary sources. Full disclosure statement.

vs. HIPAA evaluation overhead

Integrate in any language

Standard REST and an X-API-Key header, or point an agent at the MCP server.

Pythonrequests
import requests KEY = "vh_live_xxx" resp = requests.get( "https://api.verzi.health/v1/rules/receipt", params={"hcpcs": "E0601", "npi": "1234567893", "as_of": "2021-06-15", "state": "UT"}, headers={"X-API-Key": KEY}, ) receipt = resp.json()
TypeScriptfetch
const url = new URL("https://api.verzi.health/v1/rules/receipt"); url.search = new URLSearchParams({ hcpcs: "E0601", npi: "1234567893", as_of: "2021-06-15", state: "UT" }).toString(); const receipt = await (await fetch(url, { headers: { "X-API-Key": KEY }, })).json();
cURLshell
# The policy in force on a date of service (public) curl "https://api.verzi.health/v1/archive/docs/lcd:33718/as-of?date=2021-06-15" # Version history of a policy document (public) curl "https://api.verzi.health/v1/archive/docs/lcd:33718/versions"

Free current-state. Paid signed answer.

A free key covers the source archive and the catalog. Signed answers and the full CMS text are a paid plan; during the private beta, access is granted per account.

Free

Current-state and catalog

Use your work email: we email a code to confirm it, then show your key. Free email providers are not supported. No credit card.

  • Archive version listings and as-of resolution
  • The source catalog, licenses, and refresh history
  • API key with X-API-Key header authentication

Authentication

An API key for REST. OAuth or an API key for MCP.

REST: X-API-Key

Send your key in the X-API-Key header, or as Authorization: Bearer. The REST API does not use OAuth. Get a key at docs.verzi.health/signup. A TypeScript SDK is available to design partners on request.

curl -H "X-API-Key: $KEY" ...

MCP: OAuth or a key

The MCP server at https://mcp.verzi.health/mcp takes OAuth 2.1 with PKCE (S256) through auth.verzi.health, or the same API key as Authorization: Bearer or X-API-Key.

/.well-known/oauth-protected-resource

Rate limits

Two limits, and the headers that report them.

Free key

1,000 requests per day and 100 rows per response. The daily count resets at midnight UTC.

Keyless endpoints

Public endpoints with no key, such as the archive, allow 120 requests per client IP per minute.

Headers

Every counted response carries RateLimit-Policy, RateLimit, and RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. A 429 also carries Retry-After: wait that many seconds, then retry.

Versioning

/v1 under https://api.verzi.health/v1 is the stable contract.

Breaking changes ship as /v2

A breaking change ships as a new major path, /v2, and /v1 keeps working. New fields and new endpoints can land in /v1 without notice, so ignore fields you do not know.

Deprecation, then Sunset

A deprecated endpoint answers with the Deprecation header (RFC 9745). The Sunset header (RFC 8594) gives the removal date, at least 90 days before the endpoint is removed. Every user-visible change is in the changelog.

Free tier and testing

There is no separate sandbox. Test against production with the public archive and a free key.

No key

Call the public archive. /v1/archive/docs/lcd:33718/as-of?date=2024-01-15 returns the LCD version in force on that date.

Free key

Sign up at docs.verzi.health/signup. We email you a code, then show your key. No credit card. 1,000 requests per day, 100 rows per response.

Not PHI

The data is Medicare rules data, not PHI, so a test call against production exposes no patient information.

Trust by transparency

Most healthcare data platforms keep their methodology proprietary. We publish ours.

Live status

/platform/stats

Row counts, source counts, last pipeline run, last refresh status.

View live
Catalog

/sources

Every dataset we ingest, with source agency, license, refresh cadence, and last-loaded timestamp.

View catalog
Refresh history

/sources/{id}/history

Per-source audit log. Every load attempt, success or failure, timing, row counts, error message.

View example
Source archive

archive.verzi.health

Every archived version of a policy document, with effective dates, hashes, and the version in force on a date.

Open the archive
OpenAPI

/docs

Interactive reference for the archive, receipt, rules and exclusion endpoints, with request builders.

Explore

Ready to start building?

Free tier, no credit card, and the first call is a public one.

Get your API key