healthcare.dev docs

Medicare opt-out

CMS's Medicare opt-out affidavits by NPI: specialty, opt-out effective and end dates, and whether the provider may order and refer.

Version —Updated —Not published yet
SourceCMS (Opt Out Affidavits)
Source idcms-opt-out
Release cadenceAbout monthly
LicensePublic domain (US government work)
Endpoint/v1/providers/{npi}/opt-out
MCP toolcheck_medicare_opt_out
PlansEvery plan, Free included

Providers who opt out of Medicare file an affidavit with their Medicare contractor; CMS publishes the list. Each record is one affidavit: NPI, name, specialty, opt-out effective and end dates, whether CMS lists the provider as eligible to order and refer, the practice address on the affidavit and when CMS last updated it.

curl https://api.healthcare.dev/v1/providers/1720444581/opt-out \
  -H "Authorization: Bearer $HDEV_API_KEY"
  • opted_out is true when a listed affidavit's period covers today (effective on or before today, ending after it). An NPI can have affidavits in several states.
  • Opt-outs renew every two years unless the provider cancels, so opt_out_end_date moves when one renews.
  • Not listed means no opt-out affidavit recorded with this NPI as of data_version. Affidavits a later file drops stay with status: retired.
  • GET /v1/providers/{npi} links here (links.opt_out) when the file lists the NPI.