Care Connect API

Introduction

You can set up a Care Connect portal on your company website with our Care Connect API, which supports the creation of third party apps and services that use the mdsave.com network to offer procedures to their relevant patient population.

Data for procedures, providers, and pricing comes into the mdsave.com system, and can be fed into your portal via our API. This document is a high-level overview of the two API formats available.

All partners should review the Care Connect API Usage Policy.

API Options

GraphQL API

The Care Connect API documentation is available at https://developer.mdsave.com/. For a standard integration, searchOffers, createShoppingCart, and checkout are the most relevant endpoints.

Data Feed

We also provide a static JSON:API data feed of our provider offerings. Each component of the feed is provided at a unique URL secured with an API key unique to each customer. The feed is updated daily.

Procedures defines our available procedures:

{
    "type": "procedures",
    "id": "d785fc",
    "attributes": {
        "name": "Dermatology New Patient Office Visit",
        "url": "https://www.mdsave.com/procedures/dermatology-new-patient-office-visit/d785fc?utm_medium=affiliate&utm_source=Demo",
        "created-time": "2012-05-21T06:22:20+00:00",
        "last-updated-time": "2022-11-17T09:00:01+00:00"
        "specialties": [
            "d58a"
        ]
    }
}

Specialties defines our available specialties.

{
    "type": "specialties",
    "id": "d28a",
    "attributes": {
        "name": "Orthopedic Surgery",
        "usnews_specialty": "Orthopaedics"
    }
}

Providers lists all providers on the system.

{
    "type": "providers",
    "id": "d781f8cb",
    "attributes": {
        "prefix": "Dr.",
        "suffix": "",
        "first-name": "Cheriparambil",
        "last-name": "Kuruvilla Mani",
        "full-name": "Cheriparambil Kuruvilla Mani",
        "organization-name": null,
        "is-organization": false,
        "provider-name": "Dr. Cheriparambil Kuruvilla Mani",
        "provider-specialty": "Cardiology",
        "provider-npi": "1619953239",
        "hospital-npi": "1396746129",
        "hospital-name": "Memorial Health Lufkin",
        "image-url": "https://mdsave-system.s3.amazonaws.com/master/pps/d781f8cb_06.Dr.Mani.jpg",
        "provider-url": "https://www.mdsave.com/p/cheriparambil-kuruvilla-mani-memorial-health-lufkin?utm_medium=affiliate&utm_source=Demo%22, 
        "created-time": "2015-09-28T20:25:35+00:00",
        "last-updated-time": "2022-11-16T11:30:01+00:00",
        "addresses": [
            {
                "street": "1201 West Frank Street",
                "city": "Lufkin",
                "state": "TX",
                "zip-code": "75904",
                "latitude": 31.323396,
                "longitude": -94.805957
            }
        ],
        "rating-count": 1,
        "rating-average": 5
    },
    "relationships": {
      "facilities": {
        "links": {
          "self": "https://www.mdsave.com/tendo/facilities/d580fc?api_key=94BE804B-FE8F-4D90-A805-40FA1AF93A0B"
        },
        "data": [
          {
            "type": "facilities",
            "id": "d580fc"
           }
        ]
      }
   }
}

Facilities lists the facilities (i.e., hospitals and clinics) available on MDsave.

{
            "type": "facilities",
            "id": "d286fe",
            "attributes": {
                "name": "Hunt Regional Healthcare",
                "npi": "1598750721",
                "ccn": "450352",
                "encoded_id": "d286fe",
                "url": "https://www.mdsave.com/hunt-regional-healthcare?utm_medium=affiliate&utm_source=Tendo",
                "logo": "https://mdsave-system.s3.amazonaws.com/master/temp/covers/original/5db2a5bedd061_1571988926.png",
                "division_name": "Hunt Regional",
                "system_name": "Hunt Regional Medical Center"
            },
            "links": {
                "self": "https://www.mdsave.com/tendo/facilities/d286fe?api_key=94BE804B-FE8F-4D90-A805-40FA1AF93A0B"
            }
        }

Offers lists the actual provider + procedure offers available for sale.

{
    "type": "offers",
    "id": "d782ffcc67da",
    "attributes": {
        "schedule_type": "Call to schedule",
        "schedule_url": null,
        "schedule_phone": "9366348311",
        "price": "21",
        "info": "Procedure Details: This includes a hemoglobin A1C test.<br/><br/>Price Details: Your purchase includes the following services:<br/>Facility fee - collection of the sample (blood draw, urine collection, stool sample, etc.) and testing.",
        "url": "https://www.mdsave.com/p/woodland-heights-medical-center-lab-work-and-drug-testing/hemoglobin-a1c/d782ffcc67da?utm_medium=affiliate&utm_source=Demo",
        "cpt-codes": [
            "83036"
        ],
        "created-time": "2018-05-04T14:52:59+00:00",
        "last-updated-time": "2022-01-04T04:06:32+00:00",
        "cpt-first-level": "83036"
    },
    "relationships": {
        "procedures": {
            "links": {
                "self": "https://www.mdsave.com/procedures/d786f5c8?api_key=6C5FF954-0C3E-4674-8387-D24E1D181257"
            },
            "data": [
                {
                    "type": "procedures",
                    "id": "d786f5c8"
                }
            ]
        },
        "providers": {
            "links": {
                "self": "https://www.mdsave.com/providers/d28bf9ca?api_key=6C5FF954-0C3E-4674-8387-D24E1D181257"
            },
            "data": [
                {
                    "type": "providers",
                    "id": "d28bf9ca"
                }
            ]
        }
    }
}

There is one set of data feed files (procedure, provider, offer, facilities, specialities) for each Company, which includes all the networks available to that Company. If a TPA manages multiple employers/companies and each of them has different networks, the TPA would want to gather multiple sets of data feed files (one per employer/company) for a comprehensive list of offerings.