validate FHIR resources against profiles using the $validate operation and US Core

domain: fhir · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. POST the resource to {base}/{ResourceType}/$validate with the resource as the request body (or wrapped in a Parameters resource with a 'resource' parameter); include ?profile={profile-canonical-URL} to validate against a specific profile.
  2. Parse the returned OperationOutcome resource: check issue[].severity for 'error' and 'warning' entries; 'error' issues indicate non-conformance that must be fixed.
  3. For offline or CI validation, use the HL7 FHIR Validator CLI (validator_cli.jar) with the -ig flag pointing to US Core or other implementation guide packages from the FHIR package registry (packages.fhir.org).
  4. Download US Core profiles as an npm-style FHIR package (e.g. hl7.fhir.us.core) and supply them to the validator so it can resolve profile URLs and value set bindings.
  5. Address common US Core violations: missing must-support elements, unbound or incorrectly bound code values, and missing required identifiers or category codings.
  6. Integrate $validate calls into your data ingestion pipeline to catch non-conformant resources at the boundary rather than letting invalid data propagate into your store.

Known gotchas

Related routes

Validate resources against US Core profiles and check must-support field compliance
fhir · 6 steps · unrated
Validate US Core 7.0.0 Patient must-support data elements on inbound resources
hl7.org/fhir/us/core · 5 steps · unrated
Use the FHIR $validate-code terminology operation to verify that a code is valid within a specific ValueSet
hl7.org · 6 steps · unrated

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?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans