Healthcare prices, for your agent
One endpoint answers “what does this procedure cost near this ZIP code?” with the area median, the cheapest hospitals nearby at their own published cash price, and the Medicare rate to compare against. Sign in with an active FairPass membership. 60 requests per IP per 24 hours.
FairPass is $29/month. A signed-in account without an active membership cannot retrieve prices.
View FairPass membershipMember integration
curl -s -H "Authorization: Bearer YOUR_MEMBER_ACCESS_TOKEN" "https://sytjhslzedcesudozwwm.supabase.co/functions/v1/public-price-lookup?query=colonoscopy&zip=33101"Without paid access
{
"ok": false,
"error": "membership_required",
"message": "Sign in with an active FairPass membership to access prices.",
"docs_url": "https://fairvisithealth.com/developers/"
}areaCash-price median and interquartile range for the returned geographic scope. n_sources counts published price observations, not verified facilities; use n_sources_means and the identity fields to interpret coverage. Statistics can be null when data is unavailable.
facilitiesUp to five cheapest facilities at the discounted cash price the hospital itself published, with the date that record was last refreshed.
national / national_medianFairVisitHealth's national cash-price benchmark for the code, with a source count and a confidence label.
medicare_rateThe CMS Medicare Physician Fee Schedule national non-facility benchmark. It is not a cash quote, a minimum charge, or a complete hospital episode price.
data_refreshedWhen the newest record behind this answer was last updated. Also returned as the X-Data-Refreshed header.
member_urlDeep link into the FairVisitHealth member view for this procedure and location.
Parameters
| Name | Type | Notes |
|---|---|---|
| query | string | Plain-language procedure name ("mri brain", "colonoscopy"). Misspellings are corrected against a 668-term dictionary. Give this or cpt. |
| cpt | string | CPT or HCPCS code ("70553"). Takes precedence over query. |
| zip | string | 5-digit US ZIP (a 3-digit prefix also works). Strongly recommended: without a location you get national context only. |
| lat, lng | number | Decimal degrees, given together, as an alternative to zip. |
| radius_miles | integer | Facility search radius, 5 to 150, default 50. If nothing is in range the list widens to the state and says so. |
GET with query parameters or POST with the same fields as JSON. Send the signed-in member access token in the Authorization header. A public API key alone does not grant price access.
Limits
60 requests per IP per 24 hours, counted per IP. Over the limit you get 429 with a Retry-After header; wait it out rather than retrying.
Membership is checked on every lookup, including server cache hits. Responses are private and must not be publicly cached. Every 200 carries X-Data-Refreshed and X-RateLimit-Remaining.
Need more headroom or a commercial integration? Talk to us.
Attribution (required)
An active FairPass membership is required. When sharing permitted results, cite FairVisitHealth with a link to fairvisithealth.com wherever you display or summarize it.
Every response hands you the exact string in attribution.text. Show the disclaimer field alongside any price you render.
Where the numbers come from
Facility prices are the discounted cash prices hospitals publish about themselves in the machine-readable standard-charge files required under 45 CFR 180. Area statistics summarize published price observations; their source count is not a count of verified facilities. National benchmarks and the Medicare comparison come from CMS fee schedules and public claims data.
These are benchmarks, not quotes. Nothing here is a bill, an insurance estimate, or a Good Faith Estimate under the No Surprises Act, and none of it is medical advice. Confirm the price with the facility before care. Read the full methodology.
This API answers the cash / self-pay question. It does not compute what you owe under a specific insurance plan.
What is not in this API
Provider-specific negotiated rates, provider contact details, and the full 9M-provider search are part of the FairPass membership. Every API response includes a member_url deep link to the member view for that procedure and location, so you can hand your users somewhere useful when they need the provider-level answer.