Use _typeFilter on a FHIR Bulk Data $export to scope the export to a specific subset of resources meeting filter criteria

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

  1. Confirm the server advertises support for _typeFilter in its CapabilityStatement or SMART configuration before using it
  2. Construct a _typeFilter value as a URL-encoded FHIR search parameter string scoped to a resource type, for example Observation?category=laboratory
  3. Include _typeFilter alongside _type in the $export kickoff request; _type restricts which resource types are exported while _typeFilter applies search filters within those types
  4. Kick off the export with GET [base]/Patient/$export?_type=Observation&_typeFilter=Observation%3Fcategory%3Dlaboratory and the required Prefer and Accept headers
  5. Poll and download as with a standard bulk export; the resulting NDJSON will contain only resources matching the filter
  6. Validate that the manifest output entries reflect the expected resource type and that record counts are consistent with a direct FHIR search using the same parameters

Known gotchas

Related routes

Use _typeFilter on a FHIR Bulk Data $export to scope the export to only Observation resources matching a specific LOINC code filter
hl7.org · 5 steps · unrated
Execute a FHIR Bulk Data $export at the system level with _typeFilter to export only specific resource types meeting a filter criteria, then download and process the resulting NDJSON files
hl7.org/fhir · 5 steps · unrated
Run a FHIR Bulk Data group-level $export with _typeFilter and _since parameters
hl7.org/fhir/uv/bulkdata · 5 steps · unrated

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?

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