Provider Procedure Pricing

Overview

Description: Find the prices offered by a single provider for a specific procedure, with a given insurance, across practice locations.

Endpoint: /v1/pricing/providers/<npi>/procedures/<procedure_uuid>

Status: Live

Methods: GET

Example use-case: Compare insurance-specific price estimates of a Leg MRI for a single provider at multiple relevant practices (e.g., compare this provider's rates when performing the procedure at both the provider's private outpatient facility, as well as a nearby hospital system clinic where they also practice).

Request Parameters

ParameterTypeDescriptionExample
plan_iduuidExact insurance plan ID for negotiated rate with provider.
(can be retrieved from insurances endpoint)
81ba3a1a-05a9-48d9-b9b2-cb8f9eafc902
page_sizeintegerNumber of locations to return per page25
pageintegerPage number to return1

Example Request

curl -X GET \
  'https://api.ribbonhealth.com/v1/pricing/providers/1801951090/procedures/7ad7c4ef-baf9-4789-8e58-51d2308a1143?plan_id=81ba3a1a-05a9-48d9-b9b2-cb8f9eafc902' \
  -H 'authorization: Token <your_token>'
{
    "parameters": {
        "page": 1,
        "page_size": 25,
        "insurance": {
            "uuid": "ef704f14-c906-4857-acd4-d811f1394c32",
            "display": "Aetna"
        }
    },
    "locations": [
        {
            "uuid": "2711fae0-040c-4df2-98b1-513cbbcba1d4",
            "costs": {
                "min": 239,
                "avg": 520,
                "max": 714
            }
        }
      ...24 more locations...
    ]
}