Get started with Conform

Conform proves a FHIR implementation satisfies the Implementation Guides a program requires and leaves you the evidence. It is Pidgeon’s fifth product, focused on the CMS-0057-F readiness wedge.

The standalone Conform desktop app is in beta and not yet available to download. You can run the full conformance capability today from the CLI (pidgeon conform) and the Conformance panel in Post.

Run it today

From the CLI

Walk an endpoint in one command, with a non-zero exit code for CI.

Inside Post

Wire an endpoint in the Conformance panel and read results per rule.

One loop: install, walk, keep the evidence

Install the IG you're testing against

pidgeon data install fhir-us-core-3.1.1

US Core 3.1.1 is the CMS-0057-F required baseline. See CMS-0057-F for the full IG map.

Walk the endpoint

pidgeon conform --endpoint https://api.payer.example/fhir --walk --ci

--walk probes every resource × profile pair the endpoint’s CapabilityStatement declares; --ci makes must-support warnings fail the run.

Keep the evidence

pidgeon conform --endpoint https://api.payer.example/fhir --walk \
  --readiness-pack us-core-3.1.1 --evidence-out conform-evidence.json \
  --output-file scorecard.html

You get a machine-readable evidence envelope and a self-contained HTML scorecard.

When something fails

What you see	What it means	Next action
Exit code `2`	The walk validated zero resources. Nothing was declared in the CapabilityStatement, or every declared type returned an empty search	Confirm the endpoint’s CapabilityStatement and that the resources exist. A run that tested nothing is not evidence.
`MUSTSUPPORT-<path>` findings under `--ci`	A must-support element was absent from the sampled instance	These flip the exit code by design. Populate the element, or record it as a known gap in the evidence envelope.
`CONFORM_STUB_PROFILE` warning	A resource validated against an embedded subset because the IG package wasn’t installed	Install the owning IG package with `pidgeon data install <package>` and re-run.

Getting Started

Install

Desktop Apps

Post (Testing Tool)

Conform (Conformance)

Flock (Population Engine)

Loft (Observability)

Migrate (Bulk Data Migration)

Guides & Tutorials

Support

Run it today

From the CLI

Inside Post

One loop: install, walk, keep the evidence

When something fails

Next

​Run it today

From the CLI

Inside Post

​One loop: install, walk, keep the evidence

​When something fails

​Next

Run it today

One loop: install, walk, keep the evidence

When something fails

Next