epa-basic-server
type: CapabilityStatement
node role: treeRoot
resource.id:
  value: epa-basic-server
resource.meta:
  meta.profile:
    value: https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement
    index: 0
    link: https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement
domain resource.extension:
  index: 0
  element.extension:
    index: 0
    extension.url:
      value: name
    extension.value string:
      value: X-Request-ID
  element.extension:
    index: 1
    extension.url:
      value: type
    extension.value string:
      value: string
  element.extension:
    index: 2
    extension.url:
      value: description
    extension.value string:
      value: UUID of the request message
  element.extension:
    index: 3
    extension.url:
      value: format
    extension.value string:
      value: uuid
  element.extension:
    index: 4
    extension.url:
      value: required
    extension.value boolean:
      value: true
  extension.url:
    value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-header
domain resource.extension:
  index: 1
  element.extension:
    index: 0
    extension.url:
      value: name
    extension.value string:
      value: x-insurantid
  element.extension:
    index: 1
    extension.url:
      value: type
    extension.value string:
      value: string
  element.extension:
    index: 2
    extension.url:
      value: description
    extension.value string:
      value: Health Record Identifier
  element.extension:
    index: 3
    extension.url:
      value: pattern
    extension.value string:
      value: ^[A-Z]{1}\d{9}$
  element.extension:
    index: 4
    extension.url:
      value: required
    extension.value boolean:
      value: true
  extension.url:
    value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-header
domain resource.extension:
  index: 2
  element.extension:
    index: 0
    extension.url:
      value: name
    extension.value string:
      value: x-useragent
  element.extension:
    index: 1
    extension.url:
      value: type
    extension.value string:
      value: string
  element.extension:
    index: 2
    extension.url:
      value: description
    extension.value string:
      value: user agent information
  element.extension:
    index: 3
    extension.url:
      value: pattern
    extension.value string:
      value: ^[a-zA-Z0-9]{20}\/[a-zA-Z0-9\-\.]{1,15}$
  element.extension:
    index: 4
    extension.url:
      value: required
    extension.value boolean:
      value: true
  extension.url:
    value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-header
domain resource.extension:
  index: 3
  element.extension:
    index: 0
    extension.url:
      value: statusCode
    extension.value string:
      value: 403
  element.extension:
    index: 1
    extension.url:
      value: description
    extension.value string:
      value: Requestor not authorized (no user session with valid ID-Token available)
  element.extension:
    index: 2
    extension.url:
      value: responseType
    extension.value string:
      value: application/json
  element.extension:
    index: 3
    extension.url:
      value: errorCode
    extension.value string:
      value: invalAuth
  extension.url:
    value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info
domain resource.extension:
  index: 4
  element.extension:
    index: 0
    extension.url:
      value: statusCode
    extension.value string:
      value: 403
  element.extension:
    index: 1
    extension.url:
      value: description
    extension.value string:
      value: Requestor has no valid entitlement
  element.extension:
    index: 2
    extension.url:
      value: responseType
    extension.value string:
      value: application/json
  element.extension:
    index: 3
    extension.url:
      value: errorCode
    extension.value string:
      value: notEntitled
  extension.url:
    value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info
domain resource.extension:
  index: 5
  element.extension:
    index: 0
    extension.url:
      value: statusCode
    extension.value string:
      value: 403
  element.extension:
    index: 1
    extension.url:
      value: description
    extension.value string:
      value: Requestor role is not in the list of allowed user groups
  element.extension:
    index: 2
    extension.url:
      value: responseType
    extension.value string:
      value: application/json
  element.extension:
    index: 3
    extension.url:
      value: errorCode
    extension.value string:
      value: invalidOid
  extension.url:
    value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info
domain resource.extension:
  index: 6
  element.extension:
    index: 0
    extension.url:
      value: statusCode
    extension.value string:
      value: 403

index: 1
extension.url:
  value: description
extension.value string:
  value: Device registration does not exist (if requestor role is oid_versicherter only)

index: 2
extension.url:
  value: responseType
extension.value string:
  value: application/json

index: 3
extension.url:
  value: errorCode
extension.value string:
  value: unregisteredDevice

index: 7
element.extension:
  index: 0
  extension.url:
    value: statusCode
  extension.value string:
    value: 404
element.extension:
  index: 1
  extension.url:
    value: description
  extension.value string:
    value: Health record is in state UNKNOWN or INITIALIZED
element.extension:
  index: 2
  extension.url:
    value: responseType
  extension.value string:
    value: application/json
element.extension:
  index: 3
  extension.url:
    value: errorCode
  extension.value string:
    value: noHealthRecord
extension.url:
  value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info

index: 8
element.extension:
  index: 0
  extension.url:
    value: statusCode
  extension.value string:
    value: 409
element.extension:
  index: 1
  extension.url:
    value: description
  extension.value string:
    value: Request conflicts with the current state of the health record
element.extension:
  index: 2
  extension.url:
    value: responseType
  extension.value string:
    value: application/json
element.extension:
  index: 3
  extension.url:
    value: errorCode
  extension.value string:
    value: statusMismatch
extension.url:
  value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info

index: 9
element.extension:
  index: 0
  extension.url:
    value: statusCode
  extension.value string:
    value: 500
element.extension:
  index: 1
  extension.url:
    value: description
  extension.value string:
    value: Any other error
element.extension:
  index: 2
  extension.url:
    value: responseType
  extension.value string:
    value: application/json
element.extension:
  index: 3
  extension.url:
    value: errorCode
  extension.value string:
    value: internalError
extension.url:
  value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info

value: 1.3.2

value: EPABasicServer

value: EPA Basic Server

value: active

value: 2026-07-15

value: gematik GmbH

index: 0
contact detail.telecom:
  index: 0
  contact point.system:
    value: url
  contact point.value:
    value: https://www.gematik.de

value: Das Basis Capability Statement für einen FHIR Data Service in der ePA. Es beschreibt globale Header-Anforderungen und einheitliche HTTP Fehler Codes.

index: 0
codeable concept.coding:
  index: 0
  coding.system:
    value: urn:iso:std:iso:3166
  coding.code:
    value: DE

value: gematik GmbH / Dieser Implementation Guide ist lizenziert unter [Apache License](./license.html), Version 2.0.

value: requirements

value: 4.0.1

value: application/fhir+json
index: 0

index: 0
capability statement.rest.mode:
  value: server