verzi.health Log inGet a key
✓REST API · the /v1 contract

The source of truth, served over /v1.

One contract behind every surface: the warranted record for Medicare reimbursement, plus provider intelligence from 30+ federal, state, academic, and commercial sources. Every endpoint takes as_of; every envelope returns meta.as_of; every answer traces to a primary source.

Get a key Make the first call

Base https://api.verzi.health/v1 · auth X-API-Key · free tier 100 requests/day

What it is

Three doors to one room. The API is the room.

The /v1 API is the single source of truth. The SDK and the MCP server are derived from its committed OpenAPI contract, never hand-maintained in parallel. Integrate over plain HTTP from any language.

APIyou are here
Any integrator, over HTTP
The source of truth. Every endpoint takes as_of; every envelope returns meta.as_of.
SDK
A developer writing code
Deterministic, typed access, generated from the same /v1 contract. For billing and RCM vendors. →
MCP
An agent, tool-calling
Claude, Cursor, or a vendor's AI calls the warrant as a tool and reads the receipt. →

Quickstart

The first call needs no key.

The source archive and as-of resolution are public. Ask which version of a policy document was in force on a date, then sign up for a key when you want the provider data.

public · no key
# 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"
free key · provider intelligence
# Full provider dossier by NPI
curl -H "X-API-Key: vh_live_…" "https://api.verzi.health/v1/npi/1234567890"

# OIG exclusion screening
curl -H "X-API-Key: vh_live_…" "https://api.verzi.health/v1/exclusions/check/1234567890"

Signup is reviewed. A new key is created pending and activates after approval, usually within 1 business day. The full endpoint reference lives in the docs.

The surface

Public archive. Free intelligence. Paid warrant.

Every /v1 path lives behind the same contract. These are the families a claims workflow starts with.

GET /archive/docs/{doc_id}/as-of · /versions · /sources
The source archive: every captured version of a policy document, with effective dates, hashes, and the version in force on a date.
public
GET /npi/{npi} · /exclusions/… · /hospitals/… · /sources
Provider intelligence from 30+ public sources: dossiers, exclusion screening, quality, financials, market data, and the provenance catalog.
key · free tier
GET /rules/warrant · /rules/warrant/changes · /rules/…
The warrant join (standing, fee, edits, documentation, each with its receipt), the change timeline, and the individual rule reads.

Same wall on every surface. The warrant is the paid product on the API, the SDK, and the MCP alike: one entitlement, read by all three. Signed attestations ship with every warrant answer, verifiable offline.

Limits

Free to evaluate. Honest about the caps.

The free tier is for evaluation, not production volume.

Free key

Evaluate the data

Self-serve signup, reviewed by a human, no credit card.

  • 100 requests per day per key
  • 25 rows per response
  • Archive reads and version listings stay public, no key at all

Make your first call in the next minute.

The archive answers without a key. The rest is one reviewed signup away.

Get a key Read the docs

Rules data, not PHI. Nothing Verzi serves contains patient information.