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

Parameter	Type	Description	Examples
`name`	`string`	String 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`
`address`	`string`	String input of an address that will be interpreted and geocoded in real time.	`100 Main Street`
`insurance_ids`	`List<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_ids`	`List<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`
`npis`	`List<integer>`	Comma separated list of type 2 NPIs associated with the platform.	`1558319491`
`offers_appts`	`boolean`	Value of `True` or `False`. Returns platforms that offer appointments.	`True`
`panel_ages`	`string` OR `integer`	Desired 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_sexes`	`string`	Desired 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_method`	`string`	Desired payment method. Options (case-insensitive) are: `Cash Pay` `Insurance` Returns all platforms which accept the designated payment method.	`Cash Pay`
`provider_types`	`List<string>`	Comma separated list of the 'types' of providers you are searching for. Provider types are higher level groupings of specialties.	`Doctor`
`profile_claimed`	`boolean`	Value 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: Bearer <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...
   ]
}