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)
a5a0c8ff-c62b-4a9e-af86-55e52bd7dc55
page_sizeintegerNumber of locations to return per page25
pageintegerPage number to return1

Example Request

curl -X GET \
  'https://api.ribbonhealth.com/v1/pricing/providers/1992964035/procedures/112c75c4-8c6f-4d7d-905f-6beb8c36299b?insurance_id=2d5231c0-2d29-4026-9138-5dcbd0591404' \
  -H 'authorization: Token <your_token>'
{
    "parameters": {
      "insurance_id": "081de5c4-8c6f-4d7d-905f-6beb8c362",
      "page_size": 25,
      "page": 1
    },
    “locations”: [
        {
            “uuid”: “45c75c4-8c6f-4d7d-905f-6beb8c36299b”,
            “costs”: {
                        “min”: 3,
                        “med”: 3,
                        “max”: 8
            } 
        },
        {
            “uuid”: “aa9b5c4-8c6f-4d7d-905f-6beb8c36223c”,
            “costs”: {
                        “min”: 3,
                        “median”: 3,
                        “max”: 8
            } 
        },
        ... 23 more
    ]
}