GuidesAPI ReferenceTry H1!
API Reference

List Procedures (v2)

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

Browse or search the Price Transparency v2 procedure code dictionary.

Use this to resolve a CPT (or other) code before pricing lookups, or to
discover which care clusters a procedure belongs to. This endpoint does
not return dollar amounts.

Example Use Case

Look up CPT 27447 to confirm its description and see that it belongs to
the JOINT_REPLACEMENT care cluster before calling a pricing endpoint.

Notes

  • Requires Price Transparency access (doctors.can_price_transparency).
  • Rate limited to 1,000 requests per minute.
  • All Price Transparency v2 endpoints share the same response envelope:
    parameters, total_count, page, page_size, and data.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Exact procedure code filter (for example 27447).

string

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

string

Case-insensitive substring match on procedure description.

string

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

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.

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