FHIR IG analytics
| Package | de.gematik.epa.mhd |
| Resource Type | CapabilityStatement |
| Id | CapabilityStatement-epa-mhd-update-responder.json |
| FHIR Version | R4 |
| Source | https://gematik.de/fhir/epa-mhd/1.2.0-ballot.1/CapabilityStatement-epa-mhd-update-responder.html |
| URL | https://gematik.de/fhir/epa-mhd/CapabilityStatement/epa-mhd-update-responder |
| Version | 1.2.0 |
| Status | active |
| Date | 2026-12-08 |
| Name | EPAMHDUpdateResponder |
| Title | ePA MHD Service (Update Responder - Server) |
| Realm | de |
| Description | CapabilityStatement für den ePA MHD Service (Update Responder - Server) |
| Copyright | gematik GmbH / Dieser Implementation Guide ist lizenziert unter [Apache License](./license.html), Version 2.0. |
| Kind | requirements |
Resources that use this resource
No resources found
Resources that this resource uses
| CapabilityStatement |
| de.gematik.epa#1.4.0-ballot.1 | epa-basic-server | EPA Basic Server |
| ImplementationGuide |
| de.gematik.epa.mhd#1.2.0-ballot.1 | de.gematik.epa.mhd | Implementation Guide ePA MHD Service |
| de.gematik.epa#1.4.0-ballot.1 | de.gematik.epa | Implementation Guide ePA Basisfunktionalitäten |
| de.gematik.terminology#1.1.0-ballot.2 | de.gematik.terminology | TI Terminology |
| de.gematik.ti#1.5.0-ballot.2 | de.gematik.ti | Implementation Guide TI Common |
Narrative
No narrative content found in resource
Source1
{
"resourceType": "CapabilityStatement",
"id": "epa-mhd-update-responder",
"meta": {
"profile": [
"https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement"
]
},
"extension": [
{
"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-header"
},
{
"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": "Request conflicts with the current state of the health record"
},
{
"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"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-base-url",
"valueString": "http://epa4all/epa/mhd/api/v1/fhir/"
}
],
"url": "https://gematik.de/fhir/epa-mhd/CapabilityStatement/epa-mhd-update-responder",
"version": "1.2.0",
"name": "EPAMHDUpdateResponder",
"title": "ePA MHD Service (Update Responder - Server)",
"status": "active",
"date": "2026-12-08",
"publisher": "gematik GmbH",
"contact": [
{
"telecom": [
{
"system": "url",
"value": "https://www.gematik.de"
}
]
}
],
"description": "CapabilityStatement für den ePA MHD Service (Update Responder - Server)",
"jurisdiction": [
{
"coding": [
{
"system": "urn:iso:std:iso:3166",
"code": "DE"
}
]
}
],
"copyright": "gematik GmbH / Dieser Implementation Guide ist lizenziert unter [Apache License](./license.html), Version 2.0.",
"kind": "requirements",
"instantiates": [
"https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-server"
],
"imports": [
"https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-server"
],
"_imports": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}
]
}
],
"fhirVersion": "4.0.1",
"format": [
"application/fhir+json",
"application/fhir+xml"
],
"implementationGuide": [
"https://gematik.de/fhir/ti/ImplementationGuide/de.gematik.ti",
"https://gematik.de/fhir/terminology/ImplementationGuide/de.gematik.terminology",
"https://gematik.de/fhir/epa/ImplementationGuide/de.gematik.epa",
"https://gematik.de/fhir/epa-mhd/ImplementationGuide/de.gematik.epa.mhd"
],
"rest": [
{
"mode": "server",
"resource": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "200"
},
{
"url": "description",
"valueString": "Successful operation"
},
{
"url": "interaction",
"valueCode": "conditional-delete"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "400"
},
{
"url": "description",
"valueString": "Invalid query parameter(s)"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_BAD_SYNTAX"
},
{
"url": "interaction",
"valueCode": "conditional-delete"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "404"
},
{
"url": "description",
"valueString": "Resource is not known"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_NO_EXIST"
},
{
"url": "interaction",
"valueCode": "conditional-delete"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Action inconsistent with legal policy"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "legalPolicyViolation"
},
{
"url": "interaction",
"valueCode": "conditional-delete"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
}
],
"type": "DocumentReference",
"supportedProfile": [
"https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-mhd-document-reference"
],
"_supportedProfile": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}
]
}
],
"interaction": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "200"
},
{
"url": "description",
"valueString": "Successful operation"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "name",
"valueString": "X-Requesting-Organization"
},
{
"url": "type",
"valueString": "string"
},
{
"url": "description",
"valueString": "Base64 encoded FHIR Organization resource in JSON format used to identify the originator of the request"
},
{
"url": "format",
"valueString": "base64(fhir+json:Organization)"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "431"
},
{
"url": "description",
"valueString": "Requesting Organization Header exceeds maximum size"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_ORG_HEADER_TOO_LARGE"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "name",
"valueString": "If-Match"
},
{
"url": "type",
"valueString": "string"
},
{
"url": "description",
"valueString": "Version (meta.versionId) of the resource the update is based on, in the form W/\"[versionId]\""
},
{
"url": "pattern",
"valueString": "^W/\"[0-9]+\"$"
},
{
"url": "required",
"valueBoolean": true
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-header"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "422"
},
{
"url": "description",
"valueString": "Profile mismatch in header Organization"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_ORG_HEADER_PROFILE_MISMATCH"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "ID-Token or Insurant-ID mismatch"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "SVC_IDENTITY_MISMATCH"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "404"
},
{
"url": "description",
"valueString": "Resource is not known"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_NO_EXIST"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "400"
},
{
"url": "description",
"valueString": "Bad Request - resource could not be parsed or failed basic FHIR validation rules"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_BAD_SYNTAX"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "422"
},
{
"url": "description",
"valueString": "Unprocessable Entity - the proposed resource violated applicable FHIR profiles or server business rules"
},
{
"url": "responseType",
"valueString": "EPAMHDOperationOutcome"
},
{
"url": "errorCode",
"valueString": "[proper code from EPAMHDOperationOutcomeDetailsCS]"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "412"
},
{
"url": "description",
"valueString": "Precondition failed - the given resouce version is outdated"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "versionConflict"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "400"
},
{
"url": "description",
"valueString": "No If-Match header with resource version given"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "missingIfMatchHeader"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "403"
},
{
"url": "description",
"valueString": "Action inconsistent with legal policy"
},
{
"url": "responseType",
"valueString": "application/json"
},
{
"url": "errorCode",
"valueString": "legalPolicyViolation"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
}
],
"code": "update"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "200"
},
{
"url": "description",
"valueString": "Successful operation"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "404"
},
{
"url": "description",
"valueString": "Resource is not known"
},
{
"url": "responseType",
"valueString": "TIOperationOutcome"
},
{
"url": "errorCode",
"valueString": "MSG_NO_EXIST"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
},
{
"extension": [
{
"url": "statusCode",
"valueString": "422"
},
{
"url": "description",
"valueString": "Unprocessable Entity - the proposed resource violated applicable FHIR profiles or server business rules"
},
{
"url": "responseType",
"valueString": "EPAMHDOperationOutcome"
},
{
"url": "errorCode",
"valueString": "[proper code from EPAMHDOperationOutcomeDetailsCS]"
}
],
"url": "https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info"
}
],
"code": "delete"
}
],
"versioning": "versioned-update",
"readHistory": true,
"conditionalDelete": "multiple",
"searchParam": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
},
{
"url": "https://gematik.de/fhir/ti/StructureDefinition/search-parameter-interaction",
"valueCode": "conditional-delete"
}
],
"name": "format",
"definition": "http://hl7.org/fhir/SearchParameter/DocumentReference-format",
"type": "token",
"documentation": "Format Code des Dokuments; ausschließlich für das bedingte Löschen des Zahnbonushefts durch das ePA-FdV mit dem Wert urn:gematik:ig:Zahnbonusheft:v1.1.0"
}
]
}
]
}
]
}