Provider Price Search

Overview

Description: Search for providers that perform a given procedure and find the lowest insurance-specific price for a procedure in your area.

Endpoint: /v1/pricing/providers

Status: Live

Methods: GET

Example use-case: Search for all applicable provider negotiated rates, given a specific insurance and procedure (and optionally, a specific location/address and distance). For example, search for all providers near me who perform Leg MRIs and who take a given insurance, sorted by lowest price.

Search parameters

Parameter	Type	Description	Example
`plan_id`	`uuid`	Exact insurance plan ID for negotiated rate with provider. (can be retrieved from insurances endpoint)	`81ba3a1a-05a9-48d9-b9b2-cb8f9eafc902`
`procedure_id`	`uuid`	Exact ID for the procedure the provider performs.	`7ad7c4ef-baf9-4789-8e58-51d2308a1143`
`procedure`	`string`	Fuzzy search based on a string input. Filter to only providers who perform and have rates for the given procedure.	Leg MRI
`specialty_ids`	`List<uuid>`	A list of comma separated uuids to filter providers based on specialty i.e. `uuid1,uuid2,uuid3`	`fcc9a22c-7a0f-4405-b0c9-c5f8ad83b93e`,`8b5d3998-d7e2-4b9e-91d1-17c19cd089f5`,`44b0284c-f360-4312-a17d-d601651cb0ea`
`procedure_code`	`string`	Billing code that filters for providers who perform given code.	73720
`location`	`lat/long`	Latitude/longitude pair of coordinates in lieu of a string address (i.e. location=37.7489816,-122.4802092).	37.7489816,-122.4802092
`address`	`string`	String input of an address that will be interpreted and geocoded in real time.	2074 23rd Ave, San Francisco, CA 94116
`distance`	`integer`	Distance in miles from lat/long or address (i.e. 5 miles)	10
`page_size`	`integer`	Number of providers to return per page	25
`page`	`integer`	Page number to return	1

Procedure Reference Endpoint

Leverage the /v1/procedures endpoint (more here) to search for and see all relevant CPT codes for a procedure or bundle.

Example Request

curl -X GET \
  'https://api.ribbonhealth.com//v1/pricing/providers?address=233 Spring St, New York, NY 10013&plan_id=81ba3a1a-05a9-48d9-b9b2-cb8f9eafc902&procedure_id=7ad7c4ef-baf9-4789-8e58-51d2308a1143' \
  -H 'authorization: Token <your_token>'

Results

{
    "parameters": {
        "procedure_id": "7ad7c4ef-baf9-4789-8e58-51d2308a1143",
        "distance": 10.0,
        "page_size": 25,
        "page": 1,
        "address": "233 Spring St, Brooklyn, NY 10013, USA",
        "insurance": {
            "uuid": "ef704f14-c906-4857-acd4-d811f1394c32",
            "display": "Aetna"
        },
        "total_count": 1000
    },
    "data": [
        {
            "first_name": "Georgia",
            "middle_name": null,
            "last_name": "Gaveras",
            "age": 46,
            "gender": "f",
            "ratings_count": 3,
            "ratings_avg": 4.67,
            "degrees": [
                "DO"
            ],
            "languages": [
                "english",
                "greek",
                "polish",
                "spanish"
            ],
            "educations": [
                {
                    "type": "Fellowship",
                    "year": null,
                    "education": {
                        "name": "Mount Sinai St Luke's Emergency Department",
                        "uuid": "def0c474-bb10-4e99-b5bd-554cc1469940"
                    }
                },
                {
                    "type": "Medical School",
                    "year": 2003,
                    "education": {
                        "name": "University of New England College of Osteopathic Medicine",
                        "uuid": "0f3891b5-ad7e-4d3f-9a08-d572e406963d"
                    }
                },
                {
                    "type": "Residency",
                    "year": null,
                    "education": {
                        "name": "Division of Cardiac and Thoracic Surgery, SUNY Downstate Medical Center",
                        "uuid": "e49ef113-cb13-4484-bd07-c183c333b9ca"
                    }
                },
                {
                    "type": null,
                    "year": 2003,
                    "education": {
                        "name": "University of New England",
                        "uuid": "52389e9d-d73f-45ca-9f4d-2a14ec5eb425"
                    }
                }
            ],
            "provider_types": [
                "Doctor"
            ],
            "online_profiles": [
                {
                    "url": "https://www.doximity.com/pub/georgia-gaveras-do"
                },
                {
                    "url": "https://www.vitals.com/doctors/Dr_Georgia_Gaveras.html"
                }
            ],
            "_primary_specialties": [
                "c741df78-8460-46f6-a2ce-93de36eb7205"
            ],
            "npi": 1801951090,
            "insurance": {
                "uuid": "ef704f14-c906-4857-acd4-d811f1394c32",
                "plan_name": "null",
                "carrier_name": "Aetna"
            },
            "procedure": {
                "uuid": "7ad7c4ef-baf9-4789-8e58-51d2308a1143",
                "name": "MRI, leg"
            },
            "matched_location": {
                "uuid": "2711fae0-040c-4df2-98b1-513cbbcba1d4",
                "name": "None",
                "latitude": 40.745888,
                "longitude": -73.99149,
                "address": "109 W 27th St # 5S, New York, NY 10001, US",
                "confidence": 4,
                "costs": {
                    "min": "239.0",
                    "median": "520.5350000000001",
                    "max": "714.93"
                },
                "distance": 1.56
            }
        },
    ...999 more providers...
  ]
}