Create an Estimate

Creating an estimate with the Turquoise API is straightforward. Below, you’ll find a flow that breaks down each step. In this example, Cherry Creek Hospital is the Provider. You can select a sample patient, co-provider (optional) and treatment to see the API payload in action when generating an estimate.

Before you get started

You will need an API Key. Get started here.

Select Estimate Type

First, determine whether this estimate will involve a single provider or multiple co-providers.

Single ProviderMultiple Providers

Select a Patient

Next, select the patient recipient. Rates may vary depending on whether the patient is insured or uninsured.

Name	DOB	Insured
Frank Franklin	1990-10-21
Maria Torres	1965-12-21

Designate a Convening Provider

Next, designate a convening provider from your healthcare organization. This provider will be responsible for retrieving verified estimates from any applicable co-providers. Please select from one of the sample providers below to illustrate the experience:

Name	NPI
John Garcia MD	8947563210
Jacqueline Lee MD	1528107059

Select a Procedure

Service Description
Diagnostic Stoma Colonoscopy with Brushing/Washing Specimen Collection
Flexible Endoscopic Colonoscopy with Mucosal Resection

Request
{}

Send the Estimate

Now that you have all the necessary information, go ahead and call the Turquoise API to generate an estimate for your patient. If your API Key is already set up, you can copy the content below and give it a try.

Python
Javascript
Curl

import os
import requests
import json

url = "https://lab.turquoise.health/api/v1/gfe/"
TOKEN = os.environ.get("TURQUOISE_TOKEN")

payload = json.dumps({})
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': f'Bearer {TOKEN}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');
let data = JSON.stringify({});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://lab.turquoise.health/api/v1/gfe/',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer $TURQUOISE_API_KEY'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

  curl -L "https://lab.turquoise.health/api/v1/gfe/" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -H "Authorization: Bearer $TURQUOISE_API_KEY" \
    --data-raw "{}"
  