API Documentation

The Medical Costs API provides free, open access to medical procedure costs, drug prices, hospital data, and more.

Base URL: https://medical-costs-api.david-568.workers.dev • Download OpenAPI Spec (YAML)

Response Format

All endpoints return JSON:

{ "success": true, "data": { ... } }

Procedures

GET /api/procedures

List medical procedures with optional search, category, and body system filters.

Parameters: search, category, bodySystem, limit, offset

Try: https://medical-costs-api.david-568.workers.dev/api/procedures?search=knee&limit=10

GET /api/procedures/{code}

Get full procedure details including RVUs, rates, and geographic data.

Parameters: code (path)

Try: https://medical-costs-api.david-568.workers.dev/api/procedures/99285

GET /api/procedures/by-slug/{slug}

Look up procedure by URL slug.

Parameters: slug (path)

Try: https://medical-costs-api.david-568.workers.dev/api/procedures/by-slug/er-visit-high-severity

GET /api/procedures/{code}/consumer

Get consumer-friendly procedure description.

Parameters: code (path)

Try: https://medical-costs-api.david-568.workers.dev/api/procedures/99285/consumer

GET /api/related/{code}

Get related procedures in the same category.

Parameters: code (path)

Try: https://medical-costs-api.david-568.workers.dev/api/related/99285

GET /api/alternatives/{code}

Get alternative treatment options with cost comparison.

Parameters: code (path)

Try: https://medical-costs-api.david-568.workers.dev/api/alternatives/27447

GET /api/categories

List all procedure categories with counts.

GET /api/body-systems

List body systems with procedure counts.

GET /api/body-systems/{slug}

Get body system detail with its procedures.

Parameters: slug (path), limit, offset

Try: https://medical-costs-api.david-568.workers.dev/api/body-systems/musculoskeletal

Injuries

GET /api/injuries

List injury categories. Filter by crash relevance or body region.

Parameters: relevance, bodyRegion

Try: https://medical-costs-api.david-568.workers.dev/api/injuries?relevance=MOTOR_VEHICLE

GET /api/injuries/{slug}

Get injury category detail with mapped procedures.

Parameters: slug (path)

Try: https://medical-costs-api.david-568.workers.dev/api/injuries/traumatic-brain-injury

GET /api/injuries/{slug}/estimate

Get cost estimate for an injury by severity and state.

Parameters: slug (path), severity, state

Try: https://medical-costs-api.david-568.workers.dev/api/injuries/whiplash/estimate?severity=moderate&state=CO

GET /api/crash-estimate

Get crash severity cost estimate (NHTSA-based).

Parameters: severity, state

Try: https://medical-costs-api.david-568.workers.dev/api/crash-estimate?severity=SERIOUS_INJURY

GET /api/settlement-estimate

Estimate personal injury settlement range.

Parameters: injury (required), severity, state

Try: https://medical-costs-api.david-568.workers.dev/api/settlement-estimate?injury=whiplash&severity=moderate

Hospital

GET /api/drg

List DRG (hospital stay) codes with average costs.

Parameters: search, type (SURG/MED), limit, offset

Try: https://medical-costs-api.david-568.workers.dev/api/drg?search=knee&type=SURG

GET /api/drg/{code}

Get DRG detail with hospital-level cost breakdown.

Parameters: code (path)

Try: https://medical-costs-api.david-568.workers.dev/api/drg/470

GET /api/hospitals

Search hospitals with cost and payment data.

Parameters: state, drg, provider, search, sort, limit, offset

Try: https://medical-costs-api.david-568.workers.dev/api/hospitals?state=CO&drg=470

GET /api/hospitals/rankings

Get hospital cost rankings nationally.

Parameters: metric, direction, limit

Try: https://medical-costs-api.david-568.workers.dev/api/hospitals/rankings?metric=charges&limit=10

GET /api/hospitals/states

List states with hospital data counts.

GET /api/hospitals/{state}/drgs

Get top DRGs for a state.

Parameters: state (path), limit

Try: https://medical-costs-api.david-568.workers.dev/api/hospitals/CO/drgs

Drugs

GET /api/drugs/compare

Compare brand vs generic drug prices.

Parameters: brand (required)

Try: https://medical-costs-api.david-568.workers.dev/api/drugs/compare?brand=ozempic

GET /api/drugs/categories

List drug therapeutic categories.

GET /api/drugs/glp1

Get GLP-1 drug prices (Ozempic, Wegovy, etc.).

GET /api/medications/{conditionSlug}

Get medications commonly used for a condition.

Parameters: conditionSlug (path)

Try: https://medical-costs-api.david-568.workers.dev/api/medications/type-2-diabetes

Insurance

GET /api/insurers

List insurance companies with payment data.

Parameters: limit

GET /api/insurance-plans

Search ACA marketplace insurance plans.

Parameters: state, metal, search, limit, offset

Try: https://medical-costs-api.david-568.workers.dev/api/insurance-plans?state=CO&metal=silver

GET /api/oop-calculator

Calculate out-of-pocket costs based on insurance parameters.

Parameters: codes (required), deductible, deductible_met, coinsurance, oop_max, copay, setting, state, plan_id

Try: https://medical-costs-api.david-568.workers.dev/api/oop-calculator?codes=99285,27447&deductible=2000&coinsurance=0.2

GET /api/auto-insurance/{state}

Get auto insurance requirements by state.

Parameters: state (path)

Try: https://medical-costs-api.david-568.workers.dev/api/auto-insurance/CO

Geographic

GET /api/compare

Compare procedure costs across states.

Parameters: code (required), states

Try: https://medical-costs-api.david-568.workers.dev/api/compare?code=99285&states=CO,CA,TX,NY

Transparency

GET /api/negotiated-rates

Get negotiated rates from payers.

Parameters: code (required), state, payer, setting, limit

Try: https://medical-costs-api.david-568.workers.dev/api/negotiated-rates?code=99285

GET /api/bill-check

Check if a medical bill is reasonable.

Parameters: code (required), amount (required), state

Try: https://medical-costs-api.david-568.workers.dev/api/bill-check?code=99285&amount=2500&state=CO

Search

GET /api/search

Unified search across procedures, conditions, and drugs.

Parameters: q (required), limit

Try: https://medical-costs-api.david-568.workers.dev/api/search?q=mri&limit=10

GET /api/graph/{type}/{id}

Get knowledge graph relationships.

Parameters: type (path), id (path), relationship, limit

Try: https://medical-costs-api.david-568.workers.dev/api/graph/procedure/99285

Usage Notes

All data is based on publicly available CMS Medicare fee schedules (CY 2026, CF $33.40)
Commercial rates are estimated at 150-250% of Medicare rates
No API key required — free and open access
CORS is enabled for allowed origins
Rate limiting may apply; please be respectful with request volumes
Data is for informational purposes only and is not medical or financial advice

API Documentation

Response Format

Procedures

Injuries

Hospital

Drugs

Insurance

Geographic

Transparency

Search

Meta

Usage Notes

My Cost List