GuidesAPI ReferenceTry H1!
API Reference

Location Procedure Pricing (v2)

get
https://api.ribbonhealth.com/v2/locations//pricing/procedures

Return all procedure-level negotiated rates for a single facility /
practice location, optionally filtered by carrier.

Results are ordered cheapest-first by min.

Example Use Case

Given location 1001 and carrier 78110, list every procedure priced at
that site for that carrier, sorted from lowest to highest min.

Path parameter

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

Carrier filtering

Prefer carrier_id (from GET /v2/carriers).
plan_id is accepted in the contract but currently returns HTTP 501.
carrier_id and plan_id are mutually exclusive (HTTP 400 if both are sent).

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

Exact match on procedure coding system (for example CPT or HCPCS).

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