Sign in

Provider Directory · CMS-0057F · Da Vinci Plan-Net v1.2.0

Provider Directory

Live

Public, no-auth FHIR endpoints for in-network providers, organizations, locations, networks, plans, and endpoints. CMS-0057F mandates public read access — no registration required to query this API.

Quickstart

No auth required. Fire a request directly from curl.

curl -s \
  "https://fhir.healthchain.dev/fhir/r4/Practitioner?name=Smith&specialty=207RC0000X" \
  -H "Accept: application/fhir+json"

Required Plan-Net resources

All nine resources are mandatory per CMS-0057F §422.120.

ResourceProfileDescription
Organizationplannet-OrganizationHospitals, groups, payer entities, pharmacy organizations.
OrganizationAffiliationplannet-OrganizationAffiliationAffiliations between organizations — IPAs, ACOs, network participation.
Practitionerplannet-PractitionerIndividual clinicians, NPI-keyed.
PractitionerRoleplannet-PractitionerRoleHow a Practitioner participates at an Organization, in which Networks.
Locationplannet-LocationPhysical practice locations with geocoded lat/lon for near searches.
HealthcareServiceplannet-HealthcareServiceServices delivered (e.g., orthopedics, behavioral telehealth).
InsurancePlanplannet-InsurancePlanInsurance plans offered, with covered networks and formularies.
Networkplannet-NetworkProvider networks — named groups participating in a plan.
Endpointplannet-EndpointTechnical endpoints — DIRECT addresses, FHIR endpoints, scheduling URLs.

Endpoints

All public, unauthenticated FHIR search and read operations.

MethodPathDescription
GET/PractitionerSearch providers by name, NPI, or specialty.
GET/Practitioner/{id}Read a single Practitioner.
GET/PractitionerRole?specialty={code}Find providers by specialty (FR-DIR-002).
GET/PractitionerRole?network={ref}Find providers participating in a specific network.
GET/PractitionerRole?new-patients=acceptingFilter to providers accepting new patients.
GET/Organization?name={n}&type=provSearch organizations by name and type.
GET/OrganizationAffiliationBrowse organizational affiliations and IPA/ACO membership.
GET/Location?near={lat,lon,radius}Geographic search for locations within radius (FR-DIR-002).
GET/HealthcareServiceServices offered, filterable by category and specialty.
GET/InsurancePlanPlans offered with covered networks.
GET/EndpointTechnical endpoints exposed by orgs and providers.
GET/Organization/$exportNDJSON bulk export of the directory (FR-DIR-006).

Key searches

Common queries used by directory apps.

QueryDescription
PractitionerRole?specialty=207RC0000XCardiology providers (NUCC taxonomy code).
Location?near=39.099,-94.578&near-distance=10|miLocations within 10 miles of central Kansas City.
PractitionerRole?network=Organization/network-ppo-moProviders in the BlueShield PPO Missouri network.
PractitionerRole?new-patients=accepting&specialty=208000000XPediatricians accepting new patients.
Organization?name=Saint+Luke&type=provHospitals matching 'Saint Luke'.