CAD Developer API · v1

ICHRA plan, price, drug and network data, by API.

The same marketplace plans, age-rated premiums, formularies and in-network checks that power Choice Arrangement Deck, available to your systems through a versioned REST API.

Request a free developer account Read the API docs (v1)

Free: 600 calls/day per account · No credit card · Paid tiers coming soon

# 1. get a token
curl -u $CLIENT_ID:$CLIENT_SECRET \
  -d grant_type=client_credentials \
  https://api.choicearrangementdeck.com/v1/oauth/token

# 2. plans in Hennepin County, MN, for 2027
API=https://api.choicearrangementdeck.com
curl -H "Authorization: Bearer $TOKEN" \
  "$API/v1/plans?zipCode=55401&countyFips=27053&planYear=2027&page=1&perPage=25"

What you can call

Every endpoint lives under a version root: https://api.choicearrangementdeck.com/v1/...

plans

Health plans

Search individual-market plans by ZIP + county, metal level, carrier, network type. Plan detail with deductibles and out-of-pocket maximums.

GET /v1/plans
prices

Prices & quotes

Age and tobacco-rated premiums per plan, household quotes, and the silver benchmark used for affordability.

POST /v1/quotes
drugs

Medications

Drug search by name or RxCUI and formulary coverage (tier, prior authorization, step therapy, quantity limit) per plan.

GET /v1/drugs/{rxcui}/coverage
providers

In-network status

Look up a doctor by NPI and check which plans and networks include them, with source and as-of date.

GET /v1/providers/{npi}/network-status

Free developer tier

Calls per UTC daySpeedResponse when over
1 - 100Full speed—
101 - 6001 call / 5 s429 + Retry-After (≤ 5 s)
601+Blocked429 until 00:00 UTC

The day resets at 00:00 UTC (7:00 PM Central during CDT, 6:00 PM during CST). Token requests, /v1/me/usage, 429s and our own 5xx errors are not counted. Your dashboard shows a live meter.

How it works

  1. Request an account: name, work email, company, intended use.
  2. Confirm your email (link from support@choicearrangementdeck.com).
  3. Sign in and create your client ID + client secret (the secret is shown once).
  4. Exchange them for a 60-minute access token and call /v1.
Data is derived from public CMS marketplace files and carrier machine-readable sources. Every response carries the data version and as-of dates. Not for resale; do not send consumer personal data. See the API Terms.

Coming soon: paid tiers

Higher daily volume, no throttle band, bulk exports and an SLA, for systems that use CAD as a source of truth.

Join the waitlist

Versioned and documented

OpenAPI 3.1 per major version, Swagger UI, a changelog, and at least 12 months' notice before a version is retired.

Download openapi.json

Questions?

support@choicearrangementdeck.com