Skip to main content
A referral is a medical decision. The Perfect Referral API helps you make it well, by telling you whether a provider actually fits a given referral in practice, not just whether their specialty allows it in principle. Every answer is grounded in what providers really do, derived from public billing data, with a confidence label attached so you always know how much to trust it. If you are not sure where to begin, start with the Quickstart. It walks you from an API key to your first prediction in a few minutes.

Quickstart

Get an API key and make your first call. Start here if you want something working fast.

API reference

Every endpoint, parameter, and response field, with an interactive runner to try requests using your API token.

Methodology & limitations

How we derive labels, how we validate them, and when we don’t have enough data to make a call.

​
Get help

Questions, or something that does not look right? We want to hear it. For general questions, reach us at support@threshold.health; to flag something that looks wrong, email corrections@threshold.health. See Methodology & limitations for where the model is strong and where its limits are.