Truepill logo
Docs
Introduction
Pharmacy
Telehealth

Patient safety API

Your patients' safety is always our top priority.

Overview

Our Patient Safety APIs are the foundation of every step in our pharmacy and telehealth process. While we leverage our own APIs across our internal workflows, we also explore these safety features through our APIs to ensure patient safety is core to your experience.

About URAC

The Utilization Review Accreditation Commission, also known as URAC, is an organization that helps promote health care quality through the accreditation of organizations involved in medical care services, i.e. pharmacies. It is considered by most as the "gold standard" in pharmacy accreditation.

Our pharmacies have received the highest level of accreditation in the industry - URAC mail order and URAC specialty accreditation. Of the 60,000+ pharmacies in the country today, only ~60 have received this level of pharmacy accreditation - you are in good hands with us.

URAC Accreditation seal
Accredited
Mail Service Pharmacy
Expires 02/01/2026
URAC Accreditation seal
Accredited
Specialty Services Pharmacy
Expires 04/01/2026

URAC’s pharmacy accreditation standards cover core organizational quality, customer service, communications and disclosure, drug utilization management, pharmacy operations, and a process for mail service outcomes measurement and quality improvement.

The URAC-accredited pharmacy:

  • Promotes safety and accuracy in dispensing practices
  • Qualifies all medication distribution processes for appropriate temperature ranges
  • Provides 24/7 patient and prescriber support
  • Complies with foundational standards on risk management, consumer empowerment, and performance management
  • Reports annual performance measures to URAC
  • You can review URAC’s pharmacy Standards-at-a-Glance and Measures-at-a-Glance

How does URAC impact you?

Unlike a typical pharmacy, our URAC accreditation requires us to collect additional clinical information at every refill. These required fields of information include patient current medications, allergies and health conditions as part of the prescription intake process. Additionally, we require this information to be re-collected by your patient at every fill request.

Review URAC PHARM-OP 2 - Prescription Intake Process
icon - arrow

The organization has written policies and documented procedures for processing prescriptions that address:

  • Receipt of prescriptions via mail, telephone, in person, and electronically (e.g., fax, e-mail, and e-prescribing)
  • Safety guidelines used to process the prescription intake; (Mandatory)
  • Obtaining and maintaining:
  • Patient health history
  • Medication history
  • Allergies and past sensitivities; and
  • Any pertinent information necessary to consult with the prescriber and counsel the patient and/or caregiver;
  • Identification of high risk groups; and
  • Verification of a patient’s eligibility
Review URAC PM 5 - Periodic Patient Reassessment
icon - arrow

The organization has a process to periodically reassess the participating patient to determine if the patient is:

  • Meeting criteria for conducting medication reconciliation; (Mandatory)
  • Going to continue with current prescription medications given the disease, patient response, and medical condition; (Mandatory)
  • Experiencing any adverse effects to the medications; (Mandatory)
  • Achieving therapeutic benefits from the medication(s)
  • Adhering to therapy. Interpretive Information/Commentary Reassessment ensures the appropriateness, effectiveness, and safety of medications used by patients. An organization may define when to conduct a patient reassessment and evaluation of adherence based on clinical appropriateness.
  • Reassessment may occur with each refill, or may occur at another interval appropriate for the patient based on disease state, medication, and/or other factors (e.g., poor adherence history, co-morbidities, demographics, etc.)

Patient survey

As part of being a URAC-accredited pharmacy, you are required to collect specific patient safety details for every fill request you submit. This includes current medications, allergies and health conditions.

Each fill request needs to submit updated patient safety details as patient medications, allergies, or conditions may have changed.

You can read more about our safety standards in our Patient Safety API.

icon code

Fill request with patient survey


const body = {
  patient_token: '4526d90a',
  patient_payment_type: 'cash',
  medications: [
    {
      prescription_token: 'z3q2jr'
    },
    {
      prescription_token: '3cs873'
    }
  ],
  patient_survey: {
    medications: "Glaucoma",
    allergies:  "Bimatoprost",
    conditions: "Hay Fever",
    events: [
      {
        year: '2019',
        type: 'hospitalization',
        reason: 'food poisoning'
      },
      {
        year: '2018',
        type: 'surgery',
        reason: 'glaucoma treatment'
      }
    ]
  },
    weight: {
      value: '64.55',
      unit: 'oz',
    },
  [...other fields...]
}

fetch('https://api.truepill.com/v1/fill_request', {
  method: 'POST',
  headers: {
    Authorization: 'ApiKey tp_live_key_dwXajyzag6mhXQi1z0Gq9w',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
})
  .then(response => response.json())
  .then(response => console.log(response))

Patient survey API reference »

Allergy, conditions and drug lookup

You can use the Truepill Patient Safety API to search and retrieve a list of Allergens, Conditions, or Medications for your patient safety experience.

Each of these endpoints work similarly in that you pass in a search `keyword` and you will retrieve a list of related results. Search results will be limited to 50 entries

Each fill request needs to submit updated patient safety details as patient medications, allergies, or conditions may have changed.

You can read more about our safety standards in our Patient Safety API.

Search allergies

icon code

Patient safety allergy search


fetch('https://api.truepill.com/v1/patient_safety/allergies?keyword=pea', {
  method: 'GET',
  headers: {
    Authorization: 'ApiKey tp_live_key_dwXajyzag6mhXQi1z0Gq9w',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
})
  .then(response => response.json())
  .then(response => console.log(response))
icon success

Success response


[
  "Pear",
  "Tea Tree",
  "Palmitamide MEA",
  "Acetamide MEA",
  "Sea Cucumber",
  "Sea Whip",
  "DEA-Cetyl Phosphate",
  "Disodium Ricinoleamido MEA-Sulfosuccinate",
  "Green Tea (Camellia Sinensis)",
  "Red Beet (Beta Vulgaris)",
  "Sea Parsley (Palmaria Palmata)",
  "Urea",
  "Bee Pollens",
  "Pde5 Inhibitor",
  "Prostaglandins F2a",
  "Glucanase-beta",
  "Red Clover",
  "Imidazolidinyl Urea",
  "Diazolidinyl Urea",
  "Beta-Glucan"
]

Search conditions

icon code

Patient safety conditions search


fetch('https://api.truepill.com/v1/patient_safety/conditions?keyword=pea', {
  method: 'GET',
  headers: {
    Authorization: 'ApiKey tp_live_key_dwXajyzag6mhXQi1z0Gq9w',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
})
  .then(response => response.json())
  .then(response => console.log(response))
icon success

Success response


[
  "Open wound of head",
  "Open wound of knee and lower leg",
  "Pre-eclampsia",
  "Polycythemia vera",
  "Pre-existing hypertension with pre-eclampsia",
  "Fall from bed",
  "Open wound of neck",
  "Indeterminate sex and pseudohermaphroditism",
  "Abnormalities of heart beat",
  "Crushing injury of head",
  "Open wound of thorax",
  "Cholesteatoma of middle ear",
  "Pedal cycle rider injured in collision with other pedal cycle",
  "Pneumothorax and air leak",
  "Superficial injury of head",
  "Foreign body in ear",
  "Exposure to excessive natural heat",
  "Effects of heat and light",
  "Other diseases of inner ear",
  "Otalgia and effusion of ear"
]

Search medications

icon code

Patient survey medications search


fetch('https://api.truepill.com/v1/patient_safety/medications?keyword=pea', {
  method: 'GET',
  headers: {
    Authorization: 'ApiKey tp_live_key_dwXajyzag6mhXQi1z0Gq9w',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
})
  .then(response => response.json())
  .then(response => console.log(response))
icon success

Success response


[
  "PRE-PEN",
  "PEN-VEE K",
  "PEG-LYTE",
  "GRIS-PEG",
  "BYDUREON PEN",
  "HUMALOG PEN",
  "NUTROPIN AQ PEN",
  "SER-A-GEN",
  "HUMULIN R PEN",
  "LUPRON DEPOT-PED",
  "PEG 3350 AND ELECTROLYTES",
  "EPI E Z PEN JR",
  "EPIPEN E Z PEN",
  "HUMULIN 70/30 PEN",
  "HUMALOG MIX 50/50 PEN",
  "PBZ",
  "PBZ",
  "PCE",
  "WERA",
  "HUMALOG MIX 75/25 PEN"
]

Allergy, conditions and drug API reference »

Drug utilization

Overview

Drug utilization review (DUR) is defined as an authorized, structured, ongoing review of prescribing, dispensing and use of medication. DUR encompasses a drug review against predetermined criteria that results in changes to drug therapy when these criteria are not met. It involves a comprehensive review of patients' prescription and medication data before, during and after dispensing to ensure appropriate medication decision-making and positive patient outcomes. As a quality assurance measure, DUR programs provide corrective action, prescriber feedback and further evaluations.

DUR is classified in three categories:

  1. Prospective - evaluation of a patient's drug therapy before medication is dispensed
  2. Concurrent - ongoing monitoring of drug therapy during the course of treatment
  3. Retrospective - review of drug therapy after the patient has received the medication

Why is DUR important? 

DUR programs play a key role in helping us prioritize your patient's safety. A DUR is used to understand, interpret, evaluate and improve the prescribing, administration and use of medications. Our pharmacists play a key role in this process because of their expertise in the area of medication therapy management. DUR affords our pharmacists the opportunity to identify trends in prescribing within groups of patients whether by disease-state such as those with asthma, diabetes or high blood pressure and initiate action to improve drug therapy for patients as needed.

Prospective DUR

A Prospective DUR involves evaluating a patient's planned drug therapy before a medication is dispensed. This process allows the pharmacist to identify and resolve issues before the patient actually receives the medication. Pharmacists routinely perform prospective reviews in their daily practice by assessing a prescription medication's dosage and directions and reviewing patient information for possible drug interactions or duplicate therapy.

Issues Commonly Addressed by Prospective DUR:

  • Drug-disease contraindications
  • Therapeutic interchange
  • Generic substitution
  • Incorrect drug dosage
  • Inappropriate duration of drug treatment
  • Drug-allergy interactions
  • Clinical abuse/misuse

Example of a Prospective DUR
A patient being treated with warfarin to prevent blood clots may be prescribed a new drug by another specialist to treat arthritis. If taken together, the patient could experience internal bleeding. Upon reviewing the patient's prescriptions, the pharmacist notes the potential drug interaction and contacts the prescriber to alert him/her to the problem.

Concurrent DUR

A Concurrent DUR is performed during the course of treatment and involves the ongoing monitoring of drug therapy to ensure positive patient outcomes. Some refer to this as case management or health management. It presents pharmacists with the opportunity to alert prescribers to potential problems and to intervene in areas such as drug-drug interactions, duplicate therapy, over or underutilization, and excessive or insufficient dosing. This type of review allows therapy for a patient to be altered if necessary. Concurrent DURs often occurs in institutional settings.

Issues Commonly Addressed by Concurrent DUR:

  • Drug-drug interactions
  • Excessive doses
  • High or low dosages
  • Duplicate therapy
  • Drug-disease interactions
  • Over and underutilization
  • Drug-age precautions
  • Drug-gender precautions

Example of a Concurrent DUR
Patients in institutional settings often receive multiple medications. Periodic review of patient records can detect actual or potential drug-drug interactions or duplicate therapy. This type of review can also alert the pharmacist to the need for changes in medications such as antibiotics or the need for dosage adjustments based on laboratory test results. The key physician(s) must then be alerted to the situation so that corrective action can be taken. Drug-pregnancy precautions.

Retrospective DUR

A retrospective DUR is the simplest to perform since drug therapy is reviewed after the patient has received the medication. A retrospective review may detect patterns in prescribing, dispensing, or administering drugs to prevent recurrence of inappropriate use or abuse and serves as a means for developing prospective standards and target interventions. In retrospective DUR, patient medical charts or computerized records are screened to determine whether the drug therapy met approved criteria and aids prescribers in improving care for their patients, individually and within groups of patients, such as those with diabetes, asthma, or high blood pressure.

Issues Commonly Addressed by Retrospective DUR:

  • Therapeutic appropriateness
  • Over and underutilization
  • Appropriate generic use
  • Therapeutic duplication
  • Drug-disease contraindications
  • Drug-drug interactions
  • Incorrect drug dosage
  • Inappropriate duration of treatment
  • Clinical abuse/misuse

Example of a Retrospective DUR
An analysis of member prescription utilization may identify a of group of patients whose therapy does not meet approved guidelines. Upon retrospective review the pharmacist may identify a group of patients with asthma who, according to their medical and pharmacy history, should be using orally inhaled steroids. Using this information, the pharmacist can then encourage physicians to prescribe the indicated drugs.

Most common DUR warnings

The most common DUR warning types you will receive from our DUR Request API endpoint include:

  1. Drug-disease contraindications
  2. Drug-allergy interactions
  3. Drug-drug interaction warnings

Below are examples of the responses provided by the Truepill API for these common DUR warning types.

Inputs
Let’s assume a scenario where a patient has an allergy to sildenafil (allergy), a history of low blood pressure (condition), and is currently taking ritonavir and uroxatral (medication). And for this example, let’s say the patient has been prescribed sildenafil.

icon success

Success response


{
 "allergies": "sildenafil",
 "conditions": "history of low blood pressure",
 "medications": ["ritonavir", "uroxatral"],
 "ndc_package_code": "0093534156",
 "patient_token": "5e2b69fc8dd9fe001c1e5ee9"
}

Drug-disease contraindication

icon success

Success response


{
 "severity": "moderate",
 "type": "DRUG-DISEASE-CONTRAINDICATION",
 "warning": "Administration of Sildenafil Citrate Oral Tablet 25 MG should be used with extreme caution in Hypotension.  Since Hypotension is related to Asymptomatic Hypotension, Mild to Moderate Hypotension, Severe Initial Hypotension, and Systolic Hypotension, the same precaution may apply.",
 "subjects": [
    {
       "name": "Asymptomatic Hypotension"
    },
    {
       "name": "Hypotension"
    },
    {
       "name": "Mild to Moderate Hypotension"
    },
    {
       "name": "Severe Initial Hypotension"
    },
    {
       "name": "Systolic Hypotension"
    }
 ]
}

Drug-allergy interaction

icon success

Success response


{
 "severity": "moderate",
 "type": "DRUG-ALLERGY-INTERACTION",
 "warning": "The use of Sildenafil Citrate Oral Tablet 25 MG may result in a reaction based on a reported history of allergy to Sildenafil."
}

Drug-drug interaction

icon success

Success response


[
 {
    "severity":"severe",
    "type":"DRUG-DRUG-INTERACTION",
    "warning":"Pharmacologic effects of Sildenafil Citrate Oral Tablet 25 MG may be increased by Lopinavir-Ritonavir and Ritonavir. Elevated plasma concentrations with toxicity characterized by hypotension, visual disturbances, and priapism may occur. Sildenafil Citrate Oral Tablet 25 MG dosing adjustments are recommended. Coadministration of Lopinavir-Ritonavir and Ritonavir with sildenafil or tadalafil used in the treatment of pulmonary arterial hypertension may be contraindicated in official package labeling."
 },
 {
    "severity":"moderate",
    "type":"DRUG-DRUG-INTERACTION",
    "warning": "Phosphodiesterase type-5 inhibitors and alpha blockers may cause additive hypotension when co-administered. Because symptomatic hypotension may occur, caution is advised when vardenafil or tadalafil are co-administered with alpha blockers. Sildenafil may also be used cautiously with alpha blockers; however, doses above 25 mg should be avoided within 4 hours of alpha blocker administration. Avanafil should only be initiated in patients on stable alpha blocker therapy and at a dose of 50 mg."
 }
]

Create a DUR request

You can use the /dur_request API endpoint to request a drug utilization review from Truepill to determine your patient's safety with a certain medication. The processing time is synchronous, and on a successful DUR request response, you will receive a summary of the review based on the patient information provided.

icon code

Create a DUR request


const body = {
 allergies: ['sildenafil'],
 conditions: ['history of low blood pressure'],
 medications: [
   'ritonavir',
   'uroxatral'
 ],
 ndc_package_code: '0093534156',
 patient_token: '4526d90a'
}


fetch('https://api.truepill.com/v1/patient_safety/dur_request', {
 method: 'POST',
 headers: {
   Authorization: 'ApiKey tp_live_key_dwXajyzag6mhXQi1z0Gq9w',
   'Content-Type': 'application/json'
 },
 body: JSON.stringify(body)
})
 .then(response => response.json())
 .then(response => console.log(response))

icon success

Success response


[
 {
    "severity": "moderate",
    "type": "DRUG-DISEASE-CONTRAINDICATION",
    "warning": "Administration of Sildenafil Citrate Oral Tablet 25 MG should be used with extreme caution in Hypotension.  Since Hypotension is related to Asymptomatic Hypotension, Mild to Moderate Hypotension, Severe Initial Hypotension, and Systolic Hypotension, the same precaution may apply.",
    "subjects": [
       {
          "name": "Asymptomatic Hypotension"
       },
       {
          "name": "Hypotension"
       },
       {
          "name": "Mild to Moderate Hypotension"
       },
       {
          "name": "Severe Initial Hypotension"
       },
       {
          "name": "Systolic Hypotension"
       }
    ]
 },
 {
    "status": "moderate",
    "type": "DRUG-ALLERGY-INTERACTION",
    "warning": "The use of Sildenafil Citrate Oral Tablet 25 MG may result in a reaction based on a reported history of allergy to Sildenafil.",
    "subjects": [
       {
          "name": "Sildenafil"
       }
    ]
 },
 {
    "status": "severe",
    "type": "DRUG-DRUG-INTERACTION",
    "warning": "Pharmacologic effects of Sildenafil Citrate Oral Tablet 25 MG may be increased by Lopinavir-Ritonavir and Ritonavir. Elevated plasma concentrations with toxicity characterized by hypotension, visual disturbances, and priapism may occur. Sildenafil Citrate Oral Tablet 25 MG dosing adjustments are recommended. Coadministration of Lopinavir-Ritonavir and Ritonavir with sildenafil or tadalafil used in the treatment of pulmonary arterial hypertension may be contraindicated in official package labeling.",
    "subjects": [
       {
          "name": "Lopinavir-Ritonavir"
       },
       {
          "name": "Ritonavir"
       }
    ]
 },
 {
    "status": "moderate",
    "type": "DRUG-DRUG-INTERACTION",
    "warning": "Phosphodiesterase type-5 inhibitors and alpha blockers may cause additive hypotension when co-administered. Because symptomatic hypotension may occur caution is advised when vardenafil or tadalafil are co-administered with alpha blockers. Sildenafil may also be used cautiously with alpha blockers; however, doses above 25 mg should be avoided within 4 hours of alpha blocker administration. Avanafil should only be initiated in patients on stable alpha blocker therapy and at a dose of 50 mg.",
    "subjects": [
       {
          "name": "Uroxatral"
       }
    ]
 }
]