Search for Virtual Care Platforms

Overview

Description: The virtual care endpoint allows you to search for different at-home or virtual platforms.

Endpoint: /v1/custom/virtual_care_platforms

Status: Live -- Please Contact Us to Learn More

Example use-case: Enable a patient to find a virtual care platform that focuses on their speciality need, has licensure in the state they live in, and is in-network for their insurance plan.

Search Parameters

ParameterTypeDescriptionExamples
namestringString input of a full or partial platform name.

Note: This parameter performs a case-insensitive exact string match (i.e. is not fuzzy).
Virtual Care Platform
addressstringString input of an address that will be interpreted and geocoded in real time.100 Main Street
insurance_idsList<uuid>Comma separated list of desired insurance uuids. Returns all platforms which accept at least one of the given insurances.a5a0c8ff-c62b-4a9e-af86-55e52bd7dc55
specialty_idsList<uuid>Comma separated list of desired specialty uuids. Returns all platforms which specialize in at least one of the given specialties.fff41986-41dc-46c0-93f0-5fb3fbd47678
npisList<integer>Comma separated list of type 2 NPIs associated with the platform.1558319491
offers_apptsbooleanValue of True or False.
Returns platforms that offer appointments.
True
panel_agesstring OR integerDesired Panel Ages string. Options (case-insensitive) are:

Pediatric
Adolescent
Adult
Senior

Can instead pass the parameter an integer age.

Returns all platforms with a panel_demographics.ages label field corresponding to the entered string or integer.
Adolescent
panel_sexesstringDesired Panel Sexes string. Options (case-insensitive) are:

Female
F
Male
M

Returns all platforms with a panel_demographics.sexes label field corresponding to the entered string.
Female
payment_methodstringDesired payment method. Options (case-insensitive) are:

Cash Pay
Insurance

Returns all platforms which accept the designated payment method.
Cash Pay
provider_typesList<string>Comma separated list of the 'types' of providers you are searching for. Provider types are higher level groupings of specialties.Doctor
profile_claimedbooleanValue of True or False.
Returns care platform profiles which are curated directly by the platform.

When value is False -- Ribbon has curated on behalf of the platform and may not have complete information for concepts such as licensure or insurances accepted.
True

Example Request

curl --location --request GET 'https://api.ribbonhealth.com/v1/custom/virtual_care_platforms?address=408+broadway&specialty_ids=058148f1-3a99-4bbe-9722-6c2a54ddb860&insurance_ids=0082f872-5383-44de-9319-511f090fc56b' \
--header 'Authorization: Token <your_token>'

Results

{
   "parameters":{
      "page":1,
      "specialty_ids":[
         "058148f1-3a99-4bbe-9722-6c2a54ddb860"
      ],
      "insurance_ids":[
         "0082f872-5383-44de-9319-511f090fc56b"
      ],
      "page_size":25,
      "address":"408 broadway",
      "geocoded_state":"NY",
      "total_count":0
   },
   "data":[
      {
         "name":"RibbonCare Platform",
         "uuid":"c8fdf322-e562-479b-840d-e44931fb4112",
         "website":"https://www.ribbonvirtualcare.com",
         "description":"<p>RibbonCare is a virtual dermatology platform for eczema and psoriasis treatment.</p>",
         "geographies_served":[
            "NY",
            "TX",
            "CA"
         ],
         "npis":[
            1234567890,
            2345678910
         ],
         "specialties":[
            {
               "uuid":"b9dc44e1-6add-41f8-8df4-a8ef9cea706a",
               "taxonomy_code":"207N00000X",
               "provider_name":"Dermatologist",
               "colloquial":"Skin Care Doctor",
               "board_specialty":"Dermatology",
               "board_sub_specialty":"None",
               "non_md_specialty":null,
               "non_md_sub_specialty":null,
               "taxonomy_1":"Allopathic & Osteopathic Physicians",
               "taxonomy_2":"Dermatology",
               "taxonomy_3":null,
               "display":"Dermatology",
               "provider_type":"Doctor"
            }
         ],
         "specialties_detail":"<p>We focus on eczma and psoriasis care</p>",
         "insurances":[
            "0082f872-5383-44de-9319-511f090fc56b"
         ],
         "insurances_detail":"<p>We have flexibility to do single case agreements with other payers/plans not listed on our profile</p>",
         "sign_up_instructions":"<ol><li>Create an account</li><li>Complete an online consultation to help your provider find the best treatment plan for your needs.</li><li>A provider trained in your specialty of concern will review your information and suggest a personalized treatment plan</li><li>If prescribed, we send your medication directly to your door</li><li>Get unlimited access messaging with your provider team to answer any questions and make changes as needed</li></ol>",
         "care_delivery":[
            "Virtual Care - Asynchronous",
            "Virtual Care - Live"
         ],
         "provider_types":[
            "Doctor"
         ],
         "provider_types_detail":"<p>We also employ allied health professionals and lactation consultants</p>",
         "panel_demographics":{
            "ages":[
               "Senior (65 and over)"
            ],
            "sexes":[
               "Both female and male"
            ],
            "detail":null
         },
         "offers_appointments":true,
         "appointment_booking_detail":"<p>Patients can book an appointment through the Age Bold website: https://www.ribbonvirtualcare.com/booking</p>",
         "payment_method":[
            "Cash Pay",
            "Insurance"
         ],
         "pricing_detail":"<p>Patients have to join the RibbonCare membership to be able to consult with a doctor. The membership is an annual membership and cost $192 per year. </p><p>The visit is then billed through insurance (if we are in network with their insurance) or the cash price for a live visit is $42 per visit.</p>",
         "claimed_profile":true,
         "disclaimer":null
      },
      ... 5 more virtual care platforms...
   ]
}