Search Location Care Cluster Prices (v2)

get

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

Find location-level care-cluster (bundle) prices near an address or
lat/lng, sorted by bundle_price ascending.

Same geo / carrier / pagination rules as
GET /v2/pricing/locations/procedures.

Optional procedure_code filters to bundles whose included_procedures
contain that code.

Location required

Provide either address or both lat and lng. Missing location,
incomplete coordinates, or failed geocoding → HTTP 400.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

address

string

Free-text address or ZIP code, geocoded server-side.

Provide either address or both lat and lng. Failed geocoding returns HTTP 400.

lat

float

Latitude for a coordinate search. Must be provided together with lng.

Provide either both lat and lng, or address. Providing only one of
lat/lng returns HTTP 400.

lng

float

Longitude for a coordinate search. Must be provided together with lat.

Provide either both lat and lng, or address. Providing only one of
lat/lng returns HTTP 400.

distance_miles

float

Defaults to 25

Search radius in miles from the resolved address or coordinates. Must be greater than zero.

care_cluster_code

string

Filter to a specific care cluster by its business code (for example JOINT_REPLACEMENT).

care_cluster_description

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.

procedure_code

string

Exact procedure code filter (for example 27447).

carrier_id

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.

carrier_name

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.

plan_id

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.

page

integer

≥ 1

Defaults to 1

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

page_size

integer

1 to 100

Defaults to 20

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

Responses

200Location care cluster price hits near the search point.

400Invalid search — missing location, incomplete lat/lng, failed geocode, or mutually exclusive carrier filters.

403The caller does not have Price Transparency access.

501plan_id filtering is not implemented yet.