Skip to main content
A referral is a medical decision. The Perfect Referral API helps you make the right one. Our models address the practical questions that determine if a referral succeeds, from whether a provider’s scope actually matches a referral need to whether they still practice at their listed location today. Every answer is derived from public evidence, such as billing data, with a confidence label attached, transparent methodology, and documented limitations 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

For each model, how we derive labels, how we validate them, and when we don’t have enough confidence 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 how each model works and where its limits are.