Publish or query a health plan's provider network directory using the HL7 Da Vinci PDex Plan-Net FHIR API
domain: hl7.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
In-depth guide
FHIR Bulk Data $export gotchas — the full failure-mode walkthrough related to hl7.org, checked against official docs, with linked verified routes.
Steps
Reference the Da Vinci PDex Plan-Net implementation guide for the required FHIR R4 profiles
Implement the profiled resources: Practitioner, Organization, Location, PractitionerRole, OrganizationAffiliation, HealthCareService, and Endpoint
Expose the API as a public-facing, query-only directory endpoint per the CMS Interoperability final rule requirement that no consumer authentication be required to query it
Support queries by practitioner, specialty, or location to surface which providers and pharmacies participate in a given plan's network
Validate resource instances against the Plan-Net profiles, which build on the Validated Healthcare Directory (VhDir) base, before publishing
Confirm which CMS-regulated payer category your organization falls under (MA organization, Medicaid/CHIP FFS or managed care, or QHP issuer), since applicability traces to that categorization
Known gotchas
This is a query-only, publicly accessible API by design -- it does not support write-back or directory updates through the same interface, and CMS expects no login wall for consumers
Plan-Net is a distinct Da Vinci implementation guide from PDex Formulary -- it covers provider/network directory data, not drug coverage data, and the two should not be conflated in an integration
Applicability and enforcement details differ across CMS interoperability rules depending on payer type (MA vs. Medicaid/CHIP FFS vs. managed care vs. QHP issuer), so requirements can vary by organization
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?