Free REST API for Medical Guidelines

Use biometric and demographic data to search the same medical references used by healthcare professionals. Get personalized clinical recommendations using parameters such as weight, blood pressure, age, etc.

How does it work? Get a Key

About the Guidelines

Use this API to get medical guidelines from multiple sources like the CDC, USPSTF and American Cancer Society (references included). This initial version focuses on evidence-based preventive care (with possible future versions having specialty-specific recommendations).

For example, what is the standard of care for a 38 year-old male with high blood pressure? And what if they have diabetes?
What is necessary for a pregnant female at 27 weeks gestation?

Build a query with personalized biometric and demographic data to see what is indicated for preventive services (screening procedures, vaccinations, laboratory tests, radiographic imaging, etc). Professionals use this same peer-reviewed information at every appointment for patient care.

Yes. There's no Protected Health Information exchanged, nor is anything stored from searches (but a free token is required for access). All other user data is strictly confidential.

Organizations or individual developers can use it for apps, EMRs, websites, etc. And it's free forever. Disclaimer: some recommendations may not be included because of a lower level of evidence, requirement of advanced screening questions, or because the utility of the recommendation is based primarily on clinical judgement.

Programmer+physician Adams Briscoe. Feel free to drop me a line with questions, suggestions; also open to discussing other topics like healthcare IT, AI/ML, videogames, life with twins, etc. Developers and healthcare providers are welcome to contribute!

Endpoints and parameters


Returns all recommendations, screening procedures, and vaccinations.


Returns vaccinations only.


Body mass index. Alternatively, set kg and m, or lbs and inches to have bmi calculated and applied to corresponding guidelines.


In years. Alternatively, if dob is set (as Y-m-d or Y-m), age will be calculated.


Number of years smoking multiplied by number of packs per day. E.g. "Half a pack every day for 18 years, pack_years=9". Alternatively, set ppd (packs per day) and years_smoking.


TB skin test, measured in millimeters of induration. E.g. tst=6


Systolic blood pressure, I.e. "The top number. So, for 135/80, sbp=135."


Diastolic blood pressure, I.e. "The bottom number. So, for 135/80, dbp=80."

ldl trigs

Cholesterol profile, LDL and triglyceride.


Female, male: f m


African American (aa), hispanic, white.


Set =1, or specificy the number of weeks pregnant for prenatal guidelines.


Coronary artery calcium score.


Flag to expand results to broad match (default is exact).


Disease-specific recs. E.g. Congestive heart failure, chf Diabetes, dm. Sign in to see all conditions (too many to list here).

Response Object

Clinical recommendations for a woman who is 68 years old with diabetes. (Partial results shown.)

{ "Recommendation": "The USPSTF recommends biennial screening mammography for women aged 50 to 74 years.",
            "References": "Breast Cancer: Screening Release Date: January 2016 }, 
{ "Recommendation": "Pneumococcal Conjugate vaccine (PCV13): Indicated for all adults aged 65 or older. Protects against Pneumonia, bacteremia, and meningitis.", "References": "CDC, Pneumococcal Vaccine Timing for Adults" },
{ "Recommendation": "Low bone mass in postmenopausal women: Perform DEXA scan, and calculate FRAX score if T-scores in the -1.0 to -2.5 ranges (osteopenia). If the risk of major osteoporotic fracture is greater than or equal to 20% or the risk of hip fracture is greater than or equal to 3%, she should be offered treatment.", "References": "Kling JM, Clarke BL, Sandhu NP. Osteoporosis prevention, screening, and treatment: a review. J Womens Health. 2014 Jul;23(7):563-72." },
{ "Recommendation": "American Diabetes Association recommends a hemoglobin A1c level of less than 7.0%, preprandial glucose values of 70 to 130 mg/dL (3.9-7.2 mmol/L), and 1- to 2-hour postprandial glucose values of less than 180 mg/dL (10 mmol/L). However, American College of Physicians recommends less intensive glucose control in most cases of type 2 diabetes, saying that targeting A1c levels below 7% may increase risk for death, weight gain, hypoglycemia, and other adverse effects.", "Optional/applicable conditions": "Diabetes", "References": "1. ADA. 2. Qaseem A, Wilt TJ, Kansagara D, Horwitch C, Barry MJ, Forciea MA; Clinical Guidelines Committee of the American College of Physicians. }

Get In Touch

100% confidential, I'll get back to you ASAP.