EU Health Data API
1.0.0-ballot - ballot 150

EU Health Data API, published by HL7 Europe. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/euridice-org/eu-health-data-api/ and changes regularly. See the Directory of published versions

CapabilityStatement: Example: Document Access Provider Supporting EPS and Laboratory (Experimental)

Official URL: http://hl7.eu/fhir/health-data-api/CapabilityStatement/example-capabilitystatement-document-access-provider Version: 1.0.0-ballot
Draft as of 2026-03-10 Computable Name: ExampleDocumentAccessProviderEPSLab

Copyright/Legal: Copyright HL7 Europe. Licensed under Creative Commons public domain (CC0 1.0).

Raw OpenAPI-Swagger Definition file | Download

Language: en

Example: Document Access Provider Supporting EPS and Laboratory

  • Implementation Guide Version: 1.0.0-ballot
  • FHIR Version: 4.0.1
  • Supported Formats: json, xml
  • Published on: 2026-03-10
  • Published by: HL7 Europe

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

This CapabilityStatement instantiates the CapabilityStatement EEHRxF Document Access Provider CapabilityStatement

SHALL Support the Following Implementation Guides

  • http://hl7.eu/fhir/eps
  • http://hl7.eu/fhir/laboratory

FHIR RESTful Capabilities

Mode: server

This server provides document exchange for European Patient Summaries and Laboratory Reports. It supports MHD ITI-67 (Find Document References), ITI-68 (Retrieve Document), and PDQm ITI-78 (Patient Demographics Query).

Security
Enable CORS: no
Security services supported: SMART-on-FHIR

SMART Backend Services authorization required.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
DocumentReference yy_id, _lastUpdated, author.given, author.family, category, creation, date, event, facility, format, identifier, patient, patient.identifier, period, related, security-label, setting, status, type
PatientSupported Profiles
  Patient (EU core)
yyidentifier, _id

Core FHIR Resource
DocumentReference
Reference Policy
Interaction summary
  • Supports read, search-type.

Documentation

DocumentReference resources are served via ITI-67. The response uses base FHIR DocumentReference resources without a required return profile.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Logical id

SHALLcategorytoken

Document category

SHALLcreationdate

Document creation time

SHALLpatientreference

Patient reference

SHALLpatient.identifiertoken

Chained patient identifier

SHALLtypetoken

Document type

SHOULDdatedate

Reference creation time

SHOULDstatustoken

Document reference status

MAY_lastUpdateddate

Resource version last updated

MAYauthor.givenstring

Author given name

MAYauthor.familystring

Author family name

MAYeventtoken

Main clinical acts documented

MAYfacilitytoken

Facility kind

MAYformattoken

Document format

MAYidentifiertoken

Document identifier

MAYperioddate

Documented service period

MAYrelatedreference

Related identifier or resource

MAYsecurity-labeltoken

Document security label

MAYsettingtoken

Clinical setting

 
Core FHIR Resource
Patient
Reference Policy
Interaction summary
  • Supports read, search-type.

Supported Profiles

Patient (EU core)

Documentation

Patient lookup via PDQm ITI-78.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLidentifiertoken
SHALL_idtoken