GuidesAPI ReferenceTry H1!
API Reference

Location Care Cluster Pricing (v2)

get
https://api.ribbonhealth.com/v2/locations//pricing/care-clusters

Return care-cluster (bundle) prices for a single facility / practice
location, optionally filtered by carrier.

Results are ordered cheapest-first by bundle_price.

Each record includes completeness fields so clients can see how much of the
expected procedure set has pricing at that site:
procedure_count, expected_procedure_count, completeness_pct,
included_procedures, and missing_procedures.

Path parameter

location_id accepts either the integer location id or the location UUID.
Unknown values return HTTP 404.

Carrier filtering

Prefer carrier_id. plan_id currently returns HTTP 501.
carrier_id and plan_id are mutually exclusive.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The location to look up. Accepts either the integer location id or the location UUID.

Query Params
string

Filter results to a single insurance carrier using the v2 carrier business id
(for example 78110).

Discover valid values with GET /v2/carriers. These ids are
not the same as v1 /v1/pricing/carriers UUIDs.

Mutually exclusive with plan_id — sending both returns HTTP 400.

string

Match on carrier display name. Case-insensitive substring on
/v2/carriers; case-insensitive exact match on DB-backed pricing endpoints;
case-sensitive exact match on Elasticsearch search endpoints.

string

Match on care cluster display description. Case-insensitive substring on
dictionary endpoints; case-insensitive exact match on DB-backed pricing
endpoints; case-sensitive exact match on Elasticsearch search endpoints.

string

Exact procedure code filter (for example 27447).

string

Reserved for filtering by a Ribbon insurance plan UUID.

Not functional yet — requests that include plan_id return HTTP 501 until
plan→carrier mapping is available. Prefer carrier_id today.

Mutually exclusive with carrier_id — sending both returns HTTP 400.

integer
≥ 1
Defaults to 1

Page of results to return. Values below 1 are treated as 1.

integer
1 to 100
Defaults to 20

Number of results per page. Hard-capped at 100.

Responses

Updated 5 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago