{
"description": "Das Basis Capability Statement für einen FHIR Data Service in der ePA. Es beschreibt globale Header-Anforderungen und einheitliche HTTP Fehler Codes.",
"_filename": "CapabilityStatement-epa-basic-server.json",
"package_name": "de.gematik.epa",
"format": [ "application/fhir+json" ],
"date": "2025-09-02",
"meta": {
"profile": [ "https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement" ]
},
"publisher": "gematik GmbH",
"fhirVersion": "4.0.1",
"jurisdiction": [ {
"coding": [ {
"code": "DE",
"system": "urn:iso:std:iso:3166"
} ]
} ],
"name": "EPABasicServer",
"type": null,
"experimental": null,
"resourceType": "CapabilityStatement",
"title": "EPA Basic Server",
"package_version": "1.2.0-ballot.2",
"extension": [ {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header",
"extension": [ {
"url": "name",
"valueString": "X-Request-ID"
}, {
"url": "type",
"valueString": "string"
}, {
"url": "description",
"valueString": "UUID of the request message"
}, {
"url": "format",
"valueString": "uuid"
}, {
"url": "required",
"valueBoolean": true
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header",
"extension": [ {
"url": "name",
"valueString": "x-insurantid"
}, {
"url": "type",
"valueString": "string"
}, {
"url": "description",
"valueString": "Health Record Identifier"
}, {
"url": "pattern",
"valueString": "^[A-Z]{1}\\d{9}$"
}, {
"url": "required",
"valueBoolean": true
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header",
"extension": [ {
"url": "name",
"valueString": "x-useragent"
}, {
"url": "type",
"valueString": "string"
}, {
"url": "description",
"valueString": "user agent information"
}, {
"url": "pattern",
"valueString": "^[a-zA-Z0-9]{20}\\/[a-zA-Z0-9\\-\\.]{1,15}$"
}, {
"url": "required",
"valueBoolean": true
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "403"
}, {
"url": "description",
"valueString": "Requestor not authorized (no user session with valid ID-Token available)"
}, {
"url": "responseType",
"valueString": "application/json"
}, {
"url": "errorCode",
"valueString": "invalAuth"
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "403"
}, {
"url": "description",
"valueString": "Requestor has no valid entitlement"
}, {
"url": "responseType",
"valueString": "application/json"
}, {
"url": "errorCode",
"valueString": "notEntitled"
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "403"
}, {
"url": "description",
"valueString": "Requestor role is not in the list of allowed user groups"
}, {
"url": "responseType",
"valueString": "application/json"
}, {
"url": "errorCode",
"valueString": "invalidOid"
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "403"
}, {
"url": "description",
"valueString": "Device registration does not exist (if requestor role is oid_versicherter only)"
}, {
"url": "responseType",
"valueString": "application/json"
}, {
"url": "errorCode",
"valueString": "unregisteredDevice"
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "404"
}, {
"url": "description",
"valueString": "Health record is in state UNKNOWN or INITIALIZED"
}, {
"url": "responseType",
"valueString": "application/json"
}, {
"url": "errorCode",
"valueString": "noHealthRecord"
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "409"
}, {
"url": "description",
"valueString": "Health record is in state SUSPENDED or MAINTENANCE"
}, {
"url": "responseType",
"valueString": "application/json"
}, {
"url": "errorCode",
"valueString": "statusMismatch"
} ]
}, {
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info",
"extension": [ {
"url": "statusCode",
"valueString": "500"
}, {
"url": "description",
"valueString": "Any other error"
}, {
"url": "responseType",
"valueString": "application/json"
}, {
"url": "errorCode",
"valueString": "internalError"
} ]
} ],
"status": "draft",
"id": "fe00fc9d-3075-451f-aeef-2264a34df8bd",
"kind": "requirements",
"url": "https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-server",
"version": "1.2.0-ballot.2",
"contact": [ {
"telecom": [ {
"value": "https://www.gematik.de",
"system": "url"
} ]
} ],
"rest": [ {
"mode": "server"
} ]
}