Referral Intelligence API

Refer patients to the right specialist the first time.

Get an API keyRead the docs
Who built this?

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

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

{
  "name": "Dr. Naomi Park",
  "nppesSpecialties": ["Ophthalmology"],
  "referralScopeMatches": [
    {
      "specialty": "Ophthalmology",
      "target": "Medical and surgical retina care",
      "label": "likely_match"
    }, {
      "specialty": "Ophthalmology",
      "target": "Cataract evaluation and surgery",
      "label": "very_unlikely_match"
    }
  ]
}
Built for builders

Augment your referral workflows with new insights.

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.
Pricing

Start free. Scale when you need to.

The core API is free forever. Fresher data, broader coverage, and custom work are here when you're ready.

FreeEarly Access
$0no card required

Built on public data

  • Referral scope matching for routine referrals
  • Built on public data from 2024
  • Unlimited API keys
  • Direct support from the team
Internal use and evaluation only. Not licensed for resale or for embedding in a product you sell.
Get an API key
ProComing soon

Join the waitlist

Current data, broader coverage, commercial use

  • Everything in Free
  • Newer data, broader specialist and geographic coverage
  • Higher rate limits
  • Early access to new endpoints as we ship them
Commercial sublicense — embed our outputs in a product you sell.
EnterpriseLet's talk

Custom

For custom datasets and production deployments

  • Everything in Pro
  • Custom dataset integration
  • Dedicated implementation support
  • Volume pricing and SLAs
Contact us
Start building

Bring referral intelligence to your workflows.

Start navigating provider networks with confidence. Get started today.

Get an API keyRead the docs