Run a FHIR Bulk Data group-level $export with _typeFilter and _since parameters
domain: hl7.org/fhir/uv/bulkdata · 5 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/fhir/uv/bulkdata, checked against official docs, with linked verified routes.
Steps
Authenticate using SMART Backend Services to obtain a system-scoped access token
POST a kick-off request to Group/{id}/$export including _type to restrict resource types, _typeFilter to apply additional FHIR search constraints per type, and _since to limit to resources updated after a given instant
Receive the HTTP 202 response and capture the Content-Location header pointing to the status polling URL
Poll the status URL until the response transitions from HTTP 202 to HTTP 200 with a manifest body listing output file URLs
Download NDJSON output files respecting any requiresAccessToken flag by including the access token in the Authorization header
Known gotchas
_typeFilter syntax requires each filter to be URL-encoded and associated with the resource type using a specific format defined in the Bulk Data specification; malformed filters are silently ignored by some servers, returning unfiltered data
_since uses the FHIR instant format and is compared against the resource's meta.lastUpdated; resources that were never updated after creation may have a null lastUpdated and could be excluded even if they are new
Output files may be split across multiple files per resource type; the manifest must be fully iterated rather than assuming a single file per type
Give your agent this knowledge — and 15,600+ 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?