Query documents using IHE MHD ITI-67 Find Document References and retrieve content via ITI-68

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

Steps

  1. Authenticate to the Document Responder actor's FHIR endpoint using the appropriate mechanism (OAuth2/SMART or a configured trust relationship per the deployment's security model).
  2. Execute ITI-67 by issuing a FHIR search on DocumentReference with required query parameters: at minimum, patient (or patient.identifier), and optionally status, type, category, period, or setting — verify supported parameters against the Document Responder's CapabilityStatement.
  3. Evaluate the returned searchset Bundle of DocumentReference resources; each entry describes a document including metadata (type, date, author, content type) and a URL in content.attachment.url pointing to the retrievable document.
  4. Execute ITI-68 by issuing an HTTP GET to the URL provided in DocumentReference.content.attachment.url to retrieve the actual document content; the content may be a Binary resource, a CDA XML document, PDF, or FHIR document Bundle depending on the content type.
  5. Handle content.attachment.hash and content.attachment.size values if provided to verify document integrity after retrieval.
  6. Page through ITI-67 search results using Bundle pagination links if the patient has many documents.

Known gotchas

Related routes

Implement IHE Mobile access to Health Documents (MHD) to publish and retrieve clinical documents using FHIR DocumentReference and List resources as an alternative to XDS
profiles.ihe.net/ITI/MHD · 5 steps · unrated
Implement IHE MHD Provide Document Bundle transaction to submit documents via FHIR
profiles.ihe.net · 5 steps · unrated
Implement IHE MHD ITI-65 Provide Document Bundle to submit clinical documents via FHIR
healthcare-fhir · 6 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