Referral Intelligence API

Find the right specialistevery time.

Augment your workflows with specialist insights.

Identify the best possible specialists for your patients and networks.

Purpose-built for clinical operationsWe build our predictive models with this one goal in mind.

Send referrals oncePick the right specialist the first time to prevent mismatches, re-routing, and avoidable delays in care.

Design and manage specialty networksIdentify network gaps and the best specialists to fill them.

Easily integrate our API with coding agents.

What do you want to build today?

Who's the best doctor for this retina referral?

Try demo

Find and fix access gaps in my network

Try demo

Where can my provider directory improve?

Try demo

Add scope + stale location risk to my directory

Try demo

curl https://api.perfectreferral.com/v1/practitioners/1234567890 \
  -H "Authorization: Bearer $PR_TOKEN" 

{
  "name": "NAOMI PARK",
  "referralScopeMatches": [
    {
      "specialty": "Ophthalmology",
      "target": "Cataract evaluation and surgery",
      "label": "very_unlikely_match"
    }
  ],
  "locations": [
    {
      "line1": "200 MAIN ST", "line2": "STE 5",
      "city": "SAN DIEGO", "state": "CA", "postalCode": "92103",
      "geocoding": { "latitude": 32.7469572, "longitude": -117.1663201 },
      "staleAffiliationRisk": { "label": "likely_inactive" }
    }
  ]
}

Access unique specialist insights through our API.

Make preventable routing mistakes a thing of the past.

Well-documented, easy-to-understand REST endpoints.Designed specifically to help you navigate the complexities of selecting the right specialist for a referral.
Transparent methodology and clear guidesWe document exactly how every result is derived, with step-by-step guides so you always know what's behind the data.
Frictionless API key setupCreate a free account and start building today. No demo or sales call required.

Start free. Scale when you need to.

The core API is free forever. Higher limits, a commercial license, and custom solutions are here when you're ready.

Free

$0no card required

Get data now, no demo required
Access to all data models, incl:Referral scope matchingStale location affiliation risk
Up to 10k req/mo and 50 req/s
Direct support from our team

Internal use and evaluation only. Not licensed for resale or for embedding in a product you sell.

Get an API key

Enterprise

Everything in Free, plus:

Newer data, broader coverage
Higher volume and rate limits
Early access to new data modules
Raw scores and probabilities

Commercial license — talk to us to embed our insights in a product you sell.

Custom

Everything in Enterprise, plus:

Custom-built data models
Enhanced insights with your data
Integration into your workflows
Hands-on deployment

Tailored or custom-made solutions for your referral and network teams.

Bring referral intelligence to your workflows.

Access the data Read the docs

FAQ

Who is this best for?

Perfect Referral is built for anyone frustrated with the state of referrals today. Whether you're building a network or managing referrals, from a risk-bearing entity or a digital health company. We're focused on providing the specialist insights that are missing from healthcare.

Who built this?

Perfect Referral is the data product of our company, Beeline, on a mission to improve referrals and access to care for all patients. Learn more on our main site.

How did you build this?

We build our predictive analytics using a mix of public and private data. Our detailed methodology and data sources are available in our documentation.

What are the limitations of your insights?

We believe predictions are most powerful when models are transparent about where they are right and where they are wrong. For all of our predictive models, we transparently measure, calibrate, and report their accuracy. We clearly communicate when a prediction does not meet our confidence or sufficient-data requirements. Read more about our limitations in our documentation.

Can I see your data without creating an account?

Yes! Go to our gallery of prototypes to see our insights and their applications. When ready, create an account to access our data and build with it yourself. If you're not sure how to use the API, we're happy to give you a hands-on tutorial.