Accessing Trilliant Health’s Free Basic Provider Directory API

In August of 2023, Trilliant Health announced they are now offering a publicly available version of their National Provider Directory available at no cost. The Basic tier of the Directory contains fundamental provider information like the address at their top affiliated location and key patient panel demographics. Public access users are permitted 1,000 calls per month for Type I (provider) NPI lookups and 1,000 calls per month for Type II (organization) NPI searches.

The content below provides a walk-through of signing up for and testing out Trilliant Health’s Provider Directory Basic API. For more information on Trilliant Health and provider directory solutions, see the Provider Directory page of their website.

Sign Up

Visit the developer portal at https://portal.api.trillianthealth.com/login and click Sign Up. After entering your email and name information, you’ll get a confirmation email that will prompt you to complete creating your account and take you to the main landing page.

Create an Application

Once you’re in the portal, you’ll need to create a new application. Click Provider Directory Basic to enter the product, then click Register for V1 and follow the prompts to Create an Application. You need to create an Application in order to generate credentials.

Apply Credentials

After creating an application, you’ll be prompted to Request Access. This is where you generate a key. After creating your first Application, you’ll receive a Request Access prompt. Clicking it brings you to the app management screen, where you’ll click +Generate Credentials. Give your credential a name, then click Confirm & Copy.

After clicking Confirm & Copy, the key will be on your clipboard. Keep it in a safe place, as you won’t have access to it again, and you’ll need it to test the API.

Authorization in the Portal

You’ll need to enter your key in the portal if you want to make a test call. From the app management screen, click Catalog next to your email address to get back to the portal landing page, then click Provider Directory Basic. lick Authorize and enter the key you generated in the last step, then click Close. You’re now ready to make a test call!

Make a Test Call

From the Provider Directory Basic page, click in the Lookup a provider by npi dropdown, click Try it out, enter the Type 1 (provider) NPI of your choice, and click Execute. The JSON response will appear below.

The JSON response will look like this:

{
  "npi": "1922037787",
  "active": true,
  "name": {
    "last": "LOWE",
    "first": "MICHAEL",
    "middle": "PATRICK",
    "suffix": null,
    "full": "MICHAEL PATRICK LOWE"
  },
  "credential": "MD",
  "gender": "MALE",
  "estimatedAge": 51,
  "affiliatedOrganizations": {
    "items": [
      {
        "name": "AFFILIATED ONCOLOGISTS, LLC"
      }
    ]
  },
  "affiliatedPractices": {
    "total": 3,
    "items": [
      {
        "percentOfVisits": 0.15932521087160262,
        "address": {
          "street": "4400 W 95th St",
          "city": "Oak Lawn",
          "state": "IL",
          "zipCode": "60453",
          "county": "COOK"
        },
        "latLong": {
          "lat": 41.7205696105957,
          "long": -87.73193359375
        }
      }
    ]
  },
  "patientPanel": {
    "age": {
      "median": 64,
      "percent0to19": 0.008130081300813009,
      "percent20to44": 0.14308943089430895,
      "percent45to64": 0.35772357723577236,
      "percent65to84": 0.44715447154471544,
      "percent85Plus": 0.04390243902439024
    },
    "gender": {
      "percentMale": 0.026016260162601626,
      "percentFemale": 0.967479674796748
    }
  },
  "primarySpecialty": {
    "code": "207VX0201X",
    "description": "Gynecologic Oncology Physician"
  },
  "medicalSchool": {
    "name": "UNIVERSITY OF ALABAMA SCHOOL OF MEDICINE",
    "graduationYear": "1998"
  }
}

Making a Call From Your Machine

Once you’ve got your keys working, you can leave the developer portal and try making a call from your local machine.

The Python script below will return a response for the NPI of your choice when run.

import requests

def main():
    npi = "1922037787" #provider
    api_key = 'your api key'
    user_agent = '' #leave this blank
    url = f'https://api.trillianthealth.com/v1/providers/{npi}'
    headers = {'accept': 'application/json',
               'apiKey': api_key,
               'user-agent':user_agent}

    try:
        response = requests.get(url, headers=headers)
        if response.status_code == 200:
            data = response.json()
            print(data)
        else:
            print(f"Failed to retrieve data. Status code: {response.status_code}")
    except requests.RequestException as e:
        print(f"An error occurred: {e}")

if __name__ == "__main__":
    main()

Here’s the same thing using curl.

curl --request GET --url https://api.trillianthealth.com/v1/providers/1922037787 --header 'accept: application/json'--header 'apiKey: your api key'

Future Offerings

With the public version of Provider Directory Basic, you can see up-to-date information on some of the core data points associated with a healthcare provider. Future paid versions will provide even more insight into practice patterns and patient panel including:

• Visit volume
• Top procedures and diagnoses
• Medicare, Medicaid, and Third Party insurance percentages
• Additional practice addresses
• Referring relationships
• And more!

If you have any questions regarding the current or future versions of Trilliant Health’s Provider Directory API, you can email them at inquire@trillianthealth.com or visit their contact page at https://www.trillianthealth.com/contact-us.