Operation API: Medikationsliste abrufen

Die Query-Operation medication-list liefert die elektronische Medikationsliste (eML) in Form eines FHIR 'searchSet' Bundles. Über die eML kann durch optionale Eingabe eines Datumsbereichs eine verlaufsbasierte Einsicht auf sämtliche Medikationen aus der Medikationshistorie vorgenommen werden. Auch planungsmäßig erfasste Medikationen mit aktuellen Medikationsinformationen sowie verschreibungsfreie Abgaben sind Teil der eML und können somit eingesehen werden.

OperationDefinition

Operation Definition: Get Medication List

Geschäftslogik

Voraussetzungen

Dem Medication Service MÜSSEN zur Auswertung in Operationen für jede Aktivität die folgenden Informationen bereitstehen:

  • Name des Nutzers
  • Nutzergruppe/Rolle ((profession-)oid)
  • Kennung (Telematik-ID oder KVNR)
  • Hinweis auf eine gültige Befugnis des aktuellen Benutzers (requestor)

HTTP Header-Parameter

Ein ePA-Client MUSS die folgenden HTTP Header bei einer Anfrage an den Medication Service setzen:

Name Anforderung Datentyp Beschreibung
x-insurantid MUSS String Health Record Identifier
x-useragent KANN String User Agent Information
X-Request-ID MUSS String UUID der Nachricht

Wiederholungsintervalle

Die folgenden Wiederholungsintervalle werden im Falle einer Fehlerantwort definiert:

  • '409' Conflict (statusMismatch)
    • etwa 24 Stunden
  • '500' Internal Error
    • etwa 10 Minuten

Erlaubte Nutzergruppen

professionOID
oid_versicherter
oid_praxis_arzt
oid_krankenhaus
oid_institution
oid_krankenhaus
oid_institution-vorsorge-reha
oid_zahnarztpraxis
oid_praxis_psychotherapeut
oid_institution-oegd
oid_öffentliche_apotheke
oid_institution-pflege
oid_institution-geburtshilfe
oid_praxis-physiotherapeut
oid_institution-arbeitsmedizin

Interaktion (_query=medication-list)

Medikationsliste abrufen

GET [base]/epa/medication/api/v1/fhir/?_query=medication-list

OperationId: getMedicationList_MedicationSvc

Abfrageparameter

Parameter Bedeutung Anforderung
date Begrenzt die Abfrage auf dieses Datum. Es können obere oder untere Grenzen und Zeiträume angegeben werden, indem sowohl eine obere als auch eine untere Grenze definiert wird MUSS
_count Begrenzt die Abfrage auf diese Anzahl von Einträgen MUSS
_offset Definiert die Position des ersten Eintrags MUSS

Beispielanfrage

GET [base]/epa/medication/api/v1/fhir/?_query=medication-list&date=le2024-12-24&date=ge2024-01-01&_count=5

Beispielantwort

{
    "resourceType": "Bundle",
    "id": "example-get-medication-list-bundle1",
    "identifier": {
        "value": "urn:uuid:9e1f5895-ab0b-4237-856d-fa1065631400",
        "system": "urn:ietf:rfc:3986"
    },
    "timestamp": "2025-01-01T00:00:00Z",
    "type": "searchset",
    "total": 12,
    "link":  [
        {
            "relation": "self",
            "url": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&date=le2024-12-24&date=ge2024-01-01&_count=10"
        },
        {
            "relation": "first",
            "url": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&date=le2024-12-24&date=ge2024-01-01&_count=10"
        },
        {
            "relation": "next",
            "url": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&date=le2024-12-24&date=ge2024-01-01&_count=10&_offset=10"
        },
        {
            "relation": "last",
            "url": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&date=le2024-12-24&date=ge2024-01-01&_count=10&_offset=10"
        }
    ],
    "entry":  [
        {
            "resource": {
                "resourceType": "Patient",
                "id": "8c2c989e-199a-4ca3-994c-e9ac9e69c7be",
                "meta": {
                    "profile":  [
                        "https://gematik.de/fhir/epa/StructureDefinition/epa-patient"
                    ]
                },
                "name":  [
                    {
                        "use": "official",
                        "family": "Gundlach",
                        "given":  [
                            "Monika"
                        ],
                        "prefix":  [
                            "Dr."
                        ],
                        "_prefix":  [
                            {
                                "extension":  [
                                    {
                                        "url": "http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier",
                                        "valueCode": "AC"
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "use": "maiden",
                        "family": "Blohm",
                        "_family": {
                            "extension":  [
                                {
                                    "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name",
                                    "valueString": "Blohm"
                                }
                            ]
                        }
                    }
                ],
                "identifier":  [
                    {
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "X110411319"
                    }
                ],
                "active": true,
                "gender": "female",
                "birthDate": "1954-02-27"
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Patient/8c2c989e-199a-4ca3-994c-e9ac9e69c7be"
        },
        {
            "resource": {
                "resourceType": "Organization",
                "id": "151f1697-7512-4e21-9466-1b75207475d8",
                "meta": {
                    "tag":  [
                        {
                            "system": "https://gematik.de/fhir/directory/CodeSystem/Origin",
                            "code": "ldap"
                        }
                    ],
                    "profile":  [
                        "https://gematik.de/fhir/directory/StructureDefinition/OrganizationDirectory"
                    ]
                },
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/sid/telematik-id",
                        "value": "9-2.58.00000040"
                    }
                ],
                "active": true,
                "type":  [
                    {
                        "coding":  [
                            {
                                "code": "1.2.276.0.76.4.54",
                                "system": "https://gematik.de/fhir/directory/CodeSystem/OrganizationProfessionOID",
                                "display": "Öffentliche Apotheke"
                            }
                        ]
                    }
                ],
                "name": "gematik Apotheke",
                "alias":  [
                    "Apotheke"
                ],
                "address":  [
                    {
                        "text": "gematik Apotheke\nFriedrichstr. 136, \n10117 Berlin",
                        "line":  [
                            "Friedrichstr. 136"
                        ],
                        "city": "Berlin",
                        "district": "Mitte",
                        "state": "Berlin",
                        "postalCode": "10117",
                        "country": "DE"
                    }
                ],
                "contact":  [
                    {
                        "purpose": {
                            "coding":  [
                                {
                                    "code": "ADMIN",
                                    "system": "http://terminology.hl7.org/CodeSystem/contactentity-type"
                                }
                            ]
                        },
                        "name": {
                            "text": "gematik ITSM"
                        },
                        "telecom":  [
                            {
                                "system": "email",
                                "value": "betrieb@gematik.de"
                            }
                        ]
                    }
                ]
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Organization/151f1697-7512-4e21-9466-1b75207475d8"
        },
        {
            "resource": {
                "resourceType": "Medication",
                "id": "23764122-1964-4470-9b75-c112cb5a95d8",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2024-01-01T01:01:01.000+00:00",
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication"
                    ]
                },
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/epa-medication/sid/epa-medication-unique-identifier",
                        "value": "48E951DFE10F5669D3C66D581E5767DE32CFD788C94693E5C78193DB2D3F095B"
                    }
                ],
                "code": {
                    "coding":  [
                        {
                            "system": "http://fhir.de/CodeSystem/ifa/pzn",
                            "code": "03953522",
                            "display": "Metoprolol-ratiopharm® 100 mg Tabletten"
                        },
                        {
                            "system": "http://fhir.de/CodeSystem/bfarm/atc",
                            "code": "C07AB02",
                            "display": "Metoprolol",
                            "version": "2022"
                        },
                        {
                            "system": "http://snomed.info/sct",
                            "code": "7092007",
                            "version": "http://snomed.info/sct/11000274103/version/20240515",
                            "display": "Product containing metoprolol (medicinal product)"
                        }
                    ]
                },
                "form": {
                    "coding":  [
                        {
                            "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
                            "code": "TAB",
                            "display": "Tabletten",
                            "version": "1.10"
                        },
                        {
                            "system": "http://standardterms.edqm.eu",
                            "code": "12200",
                            "display": "Tablet"
                        },
                        {
                            "system": "http://snomed.info/sct",
                            "code": "385055001",
                            "version": "http://snomed.info/sct/11000274103/version/20240515",
                            "display": "Tablet (basic dose form)"
                        }
                    ]
                },
                "amount": {
                    "numerator": {
                        "value": 100,
                        "code": "mg",
                        "system": "http://unitsofmeasure.org",
                        "unit": "MilliGram"
                    },
                    "denominator": {
                        "value": 1,
                        "code": "{Tablet}",
                        "system": "http://unitsofmeasure.org",
                        "unit": "Tablet"
                    }
                }
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Medication/23764122-1964-4470-9b75-c112cb5a95d8"
        },
        {
            "resource": {
                "resourceType": "MedicationStatement",
                "id": "0c8c5bab-19e7-4549-86a6-5738a2c62087",
                "meta": {
                    "versionId": "4",
                    "lastUpdated": "2025-01-01T00:00:00Z",
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-statement"
                    ]
                },
                "status": "active",
                "medicationReference": {
                    "reference": "urn:uuid:23764122-1964-4470-9b75-c112cb5a95d8"
                },
                "subject": {
                    "identifier": {
                        "type": {
                            "coding":  [
                                {
                                    "code": "KVZ10",
                                    "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                                    "display": "Krankenversichertennummer"
                                }
                            ]
                        },
                        "value": "X110411319",
                        "system": "http://fhir.de/sid/gkv/kvid-10"
                    }
                },
                "effectiveDateTime": "2024-01-01"
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationStatement/0c8c5bab-19e7-4549-86a6-5738a2c62087"
        },
        {
            "resource": {
                "resourceType": "MedicationRequest",
                "id": "7c2e81bc-dafa-44ff-8d82-f435937b1eec",
                "meta": {
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-request"
                    ]
                },
                "dispenseRequest": {
                    "quantity": {
                        "system": "http://unitsofmeasure.org",
                        "code": "{Package}",
                        "value": 1
                    }
                },
                "extension":  [
                    {
                        "extension":  [
                            {
                                "url": "indicator",
                                "valueBoolean": false
                            }
                        ],
                        "url": "https://gematik.de/fhir/epa-medication/StructureDefinition/multiple-prescription-extension"
                    },
                    {
                        "url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-request-linked-statement-extension",
                        "valueReference": {
                            "reference": "urn:uuid:fdb213d9-cd2b-4450-beff-9b88f3fe5475"
                        }
                    }
                ],
                "status": "completed",
                "intent": "order",
                "medicationReference": {
                    "reference": "urn:uuid:3d994488-c629-44e6-9571-85ec2dec58de"
                },
                "subject": {
                    "identifier": {
                        "type": {
                            "coding":  [
                                {
                                    "code": "KVZ10",
                                    "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                                    "display": "Krankenversichertennummer"
                                }
                            ]
                        },
                        "value": "X110411319",
                        "system": "http://fhir.de/sid/gkv/kvid-10"
                    }
                },
                "authoredOn": "2025-01-22",
                "dosageInstruction":  [
                    {
                        "text": "1-1-1-0"
                    }
                ],
                "substitution": {
                    "allowedBoolean": false
                }
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationRequest/7c2e81bc-dafa-44ff-8d82-f435937b1eec"
        },
        {
            "resource": {
                "resourceType": "MedicationDispense",
                "id": "346b564c-7e93-4082-b59c-fc471273cbea",
                "meta": {
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-dispense"
                    ]
                },
                "status": "completed",
                "category": {
                    "coding":  [
                        {
                            "code": "prescription",
                            "system": "https://gematik.de/fhir/terminology/CodeSystem/EPAMedicationDispenseCategoryCS",
                            "display": "prescription dispense"
                        }
                    ]
                },
                "medicationReference": {
                    "reference": "urn:uuid:3d994488-c629-44e6-9571-85ec2dec58de"
                },
                "subject": {
                    "identifier": {
                        "type": {
                            "coding":  [
                                {
                                    "code": "KVZ10",
                                    "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                                    "display": "Krankenversichertennummer"
                                }
                            ]
                        },
                        "value": "X110411319",
                        "system": "http://fhir.de/sid/gkv/kvid-10"
                    }
                },
                "whenHandedOver": "2025-01-22",
                "performer":  [
                    {
                        "actor": {
                            "reference": "urn:uuid:151f1697-7512-4e21-9466-1b75207475d8"
                        }
                    }
                ],
                "dosageInstruction":  [
                    {
                        "text": "1-0-0-0"
                    }
                ],
                "substitution": {
                    "wasSubstituted": false
                }
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationDispense/346b564c-7e93-4082-b59c-fc471273cbea"
        },
        {
            "resource": {
                "resourceType": "Medication",
                "id": "3d994488-c629-44e6-9571-85ec2dec58de",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2024-01-01T01:01:01.000+00:00",
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication"
                    ]
                },
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/epa-medication/sid/epa-medication-unique-identifier",
                        "value": "48E951DFE10F5669D3C66D581E5767DE32CFD788C94693E5C78193DB2D3F095B"
                    }
                ],
                "code": {
                    "coding":  [
                        {
                            "system": "http://fhir.de/CodeSystem/ifa/pzn",
                            "code": "03953522",
                            "display": "Metoprolol-ratiopharm® 100 mg Tabletten"
                        },
                        {
                            "system": "http://fhir.de/CodeSystem/bfarm/atc",
                            "code": "C07AB02",
                            "display": "Metoprolol",
                            "version": "2022"
                        },
                        {
                            "system": "http://snomed.info/sct",
                            "code": "7092007",
                            "version": "http://snomed.info/sct/11000274103/version/20240515",
                            "display": "Product containing metoprolol (medicinal product)"
                        }
                    ]
                },
                "form": {
                    "coding":  [
                        {
                            "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
                            "code": "TAB",
                            "display": "Tabletten",
                            "version": "1.10"
                        },
                        {
                            "system": "http://standardterms.edqm.eu",
                            "code": "12200",
                            "display": "Tablet"
                        },
                        {
                            "system": "http://snomed.info/sct",
                            "code": "385055001",
                            "version": "http://snomed.info/sct/11000274103/version/20240515",
                            "display": "Tablet (basic dose form)"
                        }
                    ]
                },
                "amount": {
                    "numerator": {
                        "value": 100,
                        "code": "mg",
                        "system": "http://unitsofmeasure.org",
                        "unit": "MilliGram"
                    },
                    "denominator": {
                        "value": 1,
                        "code": "{Tablet}",
                        "system": "http://unitsofmeasure.org",
                        "unit": "Tablet"
                    }
                }
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Medication/3d994488-c629-44e6-9571-85ec2dec58de"
        },
        {
            "resource": {
                "resourceType": "Medication",
                "id": "dbc5f76f-d3d3-4137-9f83-f500286408fe",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2024-01-01T01:01:01.000+00:00",
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication"
                    ]
                },
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/epa-medication/sid/epa-medication-unique-identifier",
                        "value": "B849184C973EA5FA7D9751E6FAA6AFCFFD100183596239F84DD2C0DB4C751D67"
                    }
                ],
                "code": {
                    "coding":  [
                        {
                            "system": "http://fhir.de/CodeSystem/ifa/pzn",
                            "code": "10019621",
                            "display": "IBU-ratiopharm 400mg akut Schmerztabletten"
                        },
                        {
                            "system": "http://fhir.de/CodeSystem/bfarm/atc",
                            "code": "M01AE01",
                            "display": "Ibuprofen",
                            "version": "2022"
                        }
                    ]
                },
                "form": {
                    "coding":  [
                        {
                            "system": "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM",
                            "code": "TAB",
                            "display": "Tabletten",
                            "version": "1.10"
                        },
                        {
                            "system": "http://standardterms.edqm.eu",
                            "code": "12200",
                            "display": "Tablet"
                        },
                        {
                            "system": "http://snomed.info/sct",
                            "code": "385055001",
                            "version": "http://snomed.info/sct/11000274103/version/20240515",
                            "display": "Tablet (basic dose form)"
                        }
                    ]
                },
                "amount": {
                    "numerator": {
                        "value": 50,
                        "code": "{Tablet}",
                        "system": "http://unitsofmeasure.org",
                        "unit": "Tablet"
                    },
                    "denominator": {
                        "value": 1,
                        "code": "{Package}",
                        "system": "http://unitsofmeasure.org",
                        "unit": "Package"
                    }
                },
                "ingredient":  [
                    {
                        "itemCodeableConcept": {
                            "coding":  [
                                {
                                    "code": "387207008",
                                    "system": "http://snomed.info/sct",
                                    "version": "http://snomed.info/sct/11000274103/version/20240515",
                                    "display": "Ibuprofen (substance)"
                                }
                            ]
                        },
                        "strength": {
                            "numerator": {
                                "value": 400,
                                "code": "mg",
                                "system": "http://unitsofmeasure.org",
                                "unit": "MilliGram"
                            },
                            "denominator": {
                                "value": 1,
                                "code": "{Tablet}",
                                "system": "http://unitsofmeasure.org",
                                "unit": "Tablet"
                            }
                        }
                    }
                ]
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Medication/dbc5f76f-d3d3-4137-9f83-f500286408fe"
        },
        {
            "resource": {
                "resourceType": "MedicationStatement",
                "id": "f4a5c85f-30f3-474e-9ed5-9464be6f37f8",
                "meta": {
                    "versionId": "2",
                    "lastUpdated": "2024-12-31T00:00:00Z",
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-statement"
                    ]
                },
                "status": "active",
                "medicationReference": {
                    "reference": "urn:uuid:dbc5f76f-d3d3-4137-9f83-f500286408fe"
                },
                "subject": {
                    "identifier": {
                        "type": {
                            "coding":  [
                                {
                                    "code": "KVZ10",
                                    "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                                    "display": "Krankenversichertennummer"
                                }
                            ]
                        },
                        "value": "X110411319",
                        "system": "http://fhir.de/sid/gkv/kvid-10"
                    }
                },
                "effectiveDateTime": "2024-01-01"
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationStatement/f4a5c85f-30f3-474e-9ed5-9464be6f37f8"
        },
        {
            "resource": {
                "resourceType": "MedicationRequest",
                "id": "759afdce-4f99-44f7-963b-45fbefcfe194",
                "meta": {
                    "profile":  [
                        "https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-request"
                    ]
                },
                "dispenseRequest": {
                    "quantity": {
                        "system": "http://unitsofmeasure.org",
                        "code": "{Package}",
                        "value": 1
                    }
                },
                "extension":  [
                    {
                        "extension":  [
                            {
                                "url": "indicator",
                                "valueBoolean": false
                            }
                        ],
                        "url": "https://gematik.de/fhir/epa-medication/StructureDefinition/multiple-prescription-extension"
                    },
                    {
                        "url": "https://gematik.de/fhir/epa-medication/StructureDefinition/medication-request-linked-statement-extension",
                        "valueReference": {
                            "reference": "urn:uuid:56ff3154-5890-47c9-af94-f21efe2c4ef2"
                        }
                    }
                ],
                "status": "completed",
                "intent": "order",
                "medicationReference": {
                    "reference": "urn:uuid:93dce248-91c5-49c7-870b-6d64e6df346f"
                },
                "subject": {
                    "identifier": {
                        "type": {
                            "coding":  [
                                {
                                    "code": "KVZ10",
                                    "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                                    "display": "Krankenversichertennummer"
                                }
                            ]
                        },
                        "value": "X110411319",
                        "system": "http://fhir.de/sid/gkv/kvid-10"
                    }
                },
                "authoredOn": "2025-01-22",
                "dosageInstruction":  [
                    {
                        "text": "1-0-0-0"
                    }
                ],
                "substitution": {
                    "allowedBoolean": true
                }
            },
            "fullUrl": "https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationRequest/759afdce-4f99-44f7-963b-45fbefcfe194"
        }
    ]
}
<Bundle xmlns="http://hl7.org/fhir">
    <id value="example-get-medication-list-bundle1" />
    <identifier>
        <system value="urn:ietf:rfc:3986" />
        <value value="urn:uuid:9e1f5895-ab0b-4237-856d-fa1065631400" />
    </identifier>
    <type value="searchset" />
    <timestamp value="2025-01-01T00:00:00Z" />
    <total value="12" />
    <link>
        <relation value="self" />
        <url value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&amp;date=le2024-12-24&amp;date=ge2024-01-01&amp;_count=10" />
    </link>
    <link>
        <relation value="first" />
        <url value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&amp;date=le2024-12-24&amp;date=ge2024-01-01&amp;_count=10" />
    </link>
    <link>
        <relation value="next" />
        <url value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&amp;date=le2024-12-24&amp;date=ge2024-01-01&amp;_count=10&amp;_offset=10" />
    </link>
    <link>
        <relation value="last" />
        <url value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/?_query=medication-list&amp;date=le2024-12-24&amp;date=ge2024-01-01&amp;_count=10&amp;_offset=10" />
    </link>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Patient/8c2c989e-199a-4ca3-994c-e9ac9e69c7be" />
        <resource>
            <Patient>
                <id value="8c2c989e-199a-4ca3-994c-e9ac9e69c7be" />
                <meta>
                    <profile value="https://gematik.de/fhir/epa/StructureDefinition/epa-patient" />
                </meta>
                <identifier>
                    <system value="http://fhir.de/sid/gkv/kvid-10" />
                    <value value="X110411319" />
                </identifier>
                <active value="true" />
                <name>
                    <use value="official" />
                    <family value="Gundlach" />
                    <given value="Monika" />
                    <prefix value="Dr.">
                        <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
                            <valueCode value="AC" />
                        </extension>
                    </prefix>
                </name>
                <name>
                    <use value="maiden" />
                    <family value="Blohm">
                        <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
                            <valueString value="Blohm" />
                        </extension>
                    </family>
                </name>
                <gender value="female" />
                <birthDate value="1954-02-27" />
            </Patient>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Organization/151f1697-7512-4e21-9466-1b75207475d8" />
        <resource>
            <Organization>
                <id value="151f1697-7512-4e21-9466-1b75207475d8" />
                <meta>
                    <profile value="https://gematik.de/fhir/directory/StructureDefinition/OrganizationDirectory" />
                    <tag>
                        <system value="https://gematik.de/fhir/directory/CodeSystem/Origin" />
                        <code value="ldap" />
                    </tag>
                </meta>
                <identifier>
                    <system value="https://gematik.de/fhir/sid/telematik-id" />
                    <value value="9-2.58.00000040" />
                </identifier>
                <active value="true" />
                <type>
                    <coding>
                        <system value="https://gematik.de/fhir/directory/CodeSystem/OrganizationProfessionOID" />
                        <code value="1.2.276.0.76.4.54" />
                        <display value="&#214;ffentliche Apotheke" />
                    </coding>
                </type>
                <name value="gematik Apotheke" />
                <alias value="Apotheke" />
                <address>
                    <text value="gematik Apotheke\nFriedrichstr. 136, \n10117 Berlin" />
                    <line value="Friedrichstr. 136" />
                    <city value="Berlin" />
                    <district value="Mitte" />
                    <state value="Berlin" />
                    <postalCode value="10117" />
                    <country value="DE" />
                </address>
                <contact>
                    <purpose>
                        <coding>
                            <system value="http://terminology.hl7.org/CodeSystem/contactentity-type" />
                            <code value="ADMIN" />
                        </coding>
                    </purpose>
                    <name>
                        <text value="gematik ITSM" />
                    </name>
                    <telecom>
                        <system value="email" />
                        <value value="betrieb@gematik.de" />
                    </telecom>
                </contact>
            </Organization>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Medication/23764122-1964-4470-9b75-c112cb5a95d8" />
        <resource>
            <Medication>
                <id value="23764122-1964-4470-9b75-c112cb5a95d8" />
                <meta>
                    <versionId value="1" />
                    <lastUpdated value="2024-01-01T01:01:01.000+00:00" />
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication" />
                </meta>
                <identifier>
                    <system value="https://gematik.de/fhir/epa-medication/sid/epa-medication-unique-identifier" />
                    <value value="48E951DFE10F5669D3C66D581E5767DE32CFD788C94693E5C78193DB2D3F095B" />
                </identifier>
                <code>
                    <coding>
                        <system value="http://fhir.de/CodeSystem/ifa/pzn" />
                        <code value="03953522" />
                        <display value="Metoprolol-ratiopharm&#174; 100 mg Tabletten" />
                    </coding>
                    <coding>
                        <system value="http://fhir.de/CodeSystem/bfarm/atc" />
                        <version value="2022" />
                        <code value="C07AB02" />
                        <display value="Metoprolol" />
                    </coding>
                    <coding>
                        <system value="http://snomed.info/sct" />
                        <version value="http://snomed.info/sct/11000274103/version/20240515" />
                        <code value="7092007" />
                        <display value="Product containing metoprolol (medicinal product)" />
                    </coding>
                </code>
                <form>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM" />
                        <version value="1.10" />
                        <code value="TAB" />
                        <display value="Tabletten" />
                    </coding>
                    <coding>
                        <system value="http://standardterms.edqm.eu" />
                        <code value="12200" />
                        <display value="Tablet" />
                    </coding>
                    <coding>
                        <system value="http://snomed.info/sct" />
                        <version value="http://snomed.info/sct/11000274103/version/20240515" />
                        <code value="385055001" />
                        <display value="Tablet (basic dose form)" />
                    </coding>
                </form>
                <amount>
                    <numerator>
                        <value value="100" />
                        <unit value="MilliGram" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="mg" />
                    </numerator>
                    <denominator>
                        <value value="1" />
                        <unit value="Tablet" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="{Tablet}" />
                    </denominator>
                </amount>
            </Medication>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationStatement/0c8c5bab-19e7-4549-86a6-5738a2c62087" />
        <resource>
            <MedicationStatement>
                <id value="0c8c5bab-19e7-4549-86a6-5738a2c62087" />
                <meta>
                    <versionId value="4" />
                    <lastUpdated value="2025-01-01T00:00:00Z" />
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-statement" />
                </meta>
                <status value="active" />
                <medicationReference>
                    <reference value="urn:uuid:23764122-1964-4470-9b75-c112cb5a95d8" />
                </medicationReference>
                <subject>
                    <identifier>
                        <type>
                            <coding>
                                <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                                <code value="KVZ10" />
                                <display value="Krankenversichertennummer" />
                            </coding>
                        </type>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="X110411319" />
                    </identifier>
                </subject>
                <effectiveDateTime value="2024-01-01" />
            </MedicationStatement>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationRequest/7c2e81bc-dafa-44ff-8d82-f435937b1eec" />
        <resource>
            <MedicationRequest>
                <id value="7c2e81bc-dafa-44ff-8d82-f435937b1eec" />
                <meta>
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-request" />
                </meta>
                <extension url="https://gematik.de/fhir/epa-medication/StructureDefinition/multiple-prescription-extension">
                    <extension url="indicator">
                        <valueBoolean value="false" />
                    </extension>
                </extension>
                <extension url="https://gematik.de/fhir/epa-medication/StructureDefinition/medication-request-linked-statement-extension">
                    <valueReference>
                        <reference value="urn:uuid:fdb213d9-cd2b-4450-beff-9b88f3fe5475" />
                    </valueReference>
                </extension>
                <status value="completed" />
                <intent value="order" />
                <medicationReference>
                    <reference value="urn:uuid:3d994488-c629-44e6-9571-85ec2dec58de" />
                </medicationReference>
                <subject>
                    <identifier>
                        <type>
                            <coding>
                                <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                                <code value="KVZ10" />
                                <display value="Krankenversichertennummer" />
                            </coding>
                        </type>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="X110411319" />
                    </identifier>
                </subject>
                <authoredOn value="2025-01-22" />
                <dosageInstruction>
                    <text value="1-1-1-0" />
                </dosageInstruction>
                <dispenseRequest>
                    <quantity>
                        <value value="1" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="{Package}" />
                    </quantity>
                </dispenseRequest>
                <substitution>
                    <allowedBoolean value="false" />
                </substitution>
            </MedicationRequest>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationDispense/346b564c-7e93-4082-b59c-fc471273cbea" />
        <resource>
            <MedicationDispense>
                <id value="346b564c-7e93-4082-b59c-fc471273cbea" />
                <meta>
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-dispense" />
                </meta>
                <status value="completed" />
                <category>
                    <coding>
                        <system value="https://gematik.de/fhir/terminology/CodeSystem/EPAMedicationDispenseCategoryCS" />
                        <code value="prescription" />
                        <display value="prescription dispense" />
                    </coding>
                </category>
                <medicationReference>
                    <reference value="urn:uuid:3d994488-c629-44e6-9571-85ec2dec58de" />
                </medicationReference>
                <subject>
                    <identifier>
                        <type>
                            <coding>
                                <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                                <code value="KVZ10" />
                                <display value="Krankenversichertennummer" />
                            </coding>
                        </type>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="X110411319" />
                    </identifier>
                </subject>
                <performer>
                    <actor>
                        <reference value="urn:uuid:151f1697-7512-4e21-9466-1b75207475d8" />
                    </actor>
                </performer>
                <whenHandedOver value="2025-01-22" />
                <dosageInstruction>
                    <text value="1-0-0-0" />
                </dosageInstruction>
                <substitution>
                    <wasSubstituted value="false" />
                </substitution>
            </MedicationDispense>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Medication/3d994488-c629-44e6-9571-85ec2dec58de" />
        <resource>
            <Medication>
                <id value="3d994488-c629-44e6-9571-85ec2dec58de" />
                <meta>
                    <versionId value="1" />
                    <lastUpdated value="2024-01-01T01:01:01.000+00:00" />
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication" />
                </meta>
                <identifier>
                    <system value="https://gematik.de/fhir/epa-medication/sid/epa-medication-unique-identifier" />
                    <value value="48E951DFE10F5669D3C66D581E5767DE32CFD788C94693E5C78193DB2D3F095B" />
                </identifier>
                <code>
                    <coding>
                        <system value="http://fhir.de/CodeSystem/ifa/pzn" />
                        <code value="03953522" />
                        <display value="Metoprolol-ratiopharm&#174; 100 mg Tabletten" />
                    </coding>
                    <coding>
                        <system value="http://fhir.de/CodeSystem/bfarm/atc" />
                        <version value="2022" />
                        <code value="C07AB02" />
                        <display value="Metoprolol" />
                    </coding>
                    <coding>
                        <system value="http://snomed.info/sct" />
                        <version value="http://snomed.info/sct/11000274103/version/20240515" />
                        <code value="7092007" />
                        <display value="Product containing metoprolol (medicinal product)" />
                    </coding>
                </code>
                <form>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM" />
                        <version value="1.10" />
                        <code value="TAB" />
                        <display value="Tabletten" />
                    </coding>
                    <coding>
                        <system value="http://standardterms.edqm.eu" />
                        <code value="12200" />
                        <display value="Tablet" />
                    </coding>
                    <coding>
                        <system value="http://snomed.info/sct" />
                        <version value="http://snomed.info/sct/11000274103/version/20240515" />
                        <code value="385055001" />
                        <display value="Tablet (basic dose form)" />
                    </coding>
                </form>
                <amount>
                    <numerator>
                        <value value="100" />
                        <unit value="MilliGram" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="mg" />
                    </numerator>
                    <denominator>
                        <value value="1" />
                        <unit value="Tablet" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="{Tablet}" />
                    </denominator>
                </amount>
            </Medication>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/Medication/dbc5f76f-d3d3-4137-9f83-f500286408fe" />
        <resource>
            <Medication>
                <id value="dbc5f76f-d3d3-4137-9f83-f500286408fe" />
                <meta>
                    <versionId value="1" />
                    <lastUpdated value="2024-01-01T01:01:01.000+00:00" />
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication" />
                </meta>
                <identifier>
                    <system value="https://gematik.de/fhir/epa-medication/sid/epa-medication-unique-identifier" />
                    <value value="B849184C973EA5FA7D9751E6FAA6AFCFFD100183596239F84DD2C0DB4C751D67" />
                </identifier>
                <code>
                    <coding>
                        <system value="http://fhir.de/CodeSystem/ifa/pzn" />
                        <code value="10019621" />
                        <display value="IBU-ratiopharm 400mg akut Schmerztabletten" />
                    </coding>
                    <coding>
                        <system value="http://fhir.de/CodeSystem/bfarm/atc" />
                        <version value="2022" />
                        <code value="M01AE01" />
                        <display value="Ibuprofen" />
                    </coding>
                </code>
                <form>
                    <coding>
                        <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM" />
                        <version value="1.10" />
                        <code value="TAB" />
                        <display value="Tabletten" />
                    </coding>
                    <coding>
                        <system value="http://standardterms.edqm.eu" />
                        <code value="12200" />
                        <display value="Tablet" />
                    </coding>
                    <coding>
                        <system value="http://snomed.info/sct" />
                        <version value="http://snomed.info/sct/11000274103/version/20240515" />
                        <code value="385055001" />
                        <display value="Tablet (basic dose form)" />
                    </coding>
                </form>
                <amount>
                    <numerator>
                        <value value="50" />
                        <unit value="Tablet" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="{Tablet}" />
                    </numerator>
                    <denominator>
                        <value value="1" />
                        <unit value="Package" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="{Package}" />
                    </denominator>
                </amount>
                <ingredient>
                    <itemCodeableConcept>
                        <coding>
                            <system value="http://snomed.info/sct" />
                            <version value="http://snomed.info/sct/11000274103/version/20240515" />
                            <code value="387207008" />
                            <display value="Ibuprofen (substance)" />
                        </coding>
                    </itemCodeableConcept>
                    <strength>
                        <numerator>
                            <value value="400" />
                            <unit value="MilliGram" />
                            <system value="http://unitsofmeasure.org" />
                            <code value="mg" />
                        </numerator>
                        <denominator>
                            <value value="1" />
                            <unit value="Tablet" />
                            <system value="http://unitsofmeasure.org" />
                            <code value="{Tablet}" />
                        </denominator>
                    </strength>
                </ingredient>
            </Medication>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationStatement/f4a5c85f-30f3-474e-9ed5-9464be6f37f8" />
        <resource>
            <MedicationStatement>
                <id value="f4a5c85f-30f3-474e-9ed5-9464be6f37f8" />
                <meta>
                    <versionId value="2" />
                    <lastUpdated value="2024-12-31T00:00:00Z" />
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-statement" />
                </meta>
                <status value="active" />
                <medicationReference>
                    <reference value="urn:uuid:dbc5f76f-d3d3-4137-9f83-f500286408fe" />
                </medicationReference>
                <subject>
                    <identifier>
                        <type>
                            <coding>
                                <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                                <code value="KVZ10" />
                                <display value="Krankenversichertennummer" />
                            </coding>
                        </type>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="X110411319" />
                    </identifier>
                </subject>
                <effectiveDateTime value="2024-01-01" />
            </MedicationStatement>
        </resource>
    </entry>
    <entry>
        <fullUrl value="https://epa-as-0.prod.epa4all.de/vau-cid-1234/epa/medication/api/v1/fhir/MedicationRequest/759afdce-4f99-44f7-963b-45fbefcfe194" />
        <resource>
            <MedicationRequest>
                <id value="759afdce-4f99-44f7-963b-45fbefcfe194" />
                <meta>
                    <profile value="https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-request" />
                </meta>
                <extension url="https://gematik.de/fhir/epa-medication/StructureDefinition/multiple-prescription-extension">
                    <extension url="indicator">
                        <valueBoolean value="false" />
                    </extension>
                </extension>
                <extension url="https://gematik.de/fhir/epa-medication/StructureDefinition/medication-request-linked-statement-extension">
                    <valueReference>
                        <reference value="urn:uuid:56ff3154-5890-47c9-af94-f21efe2c4ef2" />
                    </valueReference>
                </extension>
                <status value="completed" />
                <intent value="order" />
                <medicationReference>
                    <reference value="urn:uuid:93dce248-91c5-49c7-870b-6d64e6df346f" />
                </medicationReference>
                <subject>
                    <identifier>
                        <type>
                            <coding>
                                <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                                <code value="KVZ10" />
                                <display value="Krankenversichertennummer" />
                            </coding>
                        </type>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="X110411319" />
                    </identifier>
                </subject>
                <authoredOn value="2025-01-22" />
                <dosageInstruction>
                    <text value="1-0-0-0" />
                </dosageInstruction>
                <dispenseRequest>
                    <quantity>
                        <value value="1" />
                        <system value="http://unitsofmeasure.org" />
                        <code value="{Package}" />
                    </quantity>
                </dispenseRequest>
                <substitution>
                    <allowedBoolean value="true" />
                </substitution>
            </MedicationRequest>
        </resource>
    </entry>
</Bundle>

Antwort-Status-Codes

Status Code Bedingung Error Code Bemerkung
200 Successful operation EPA OperationOutcome
400 Invalid request EPA OperationOutcome
403 Requestor role is not in the list of allowed user groups invalidOid
403 Requestor is not entitled notEntitled
403 ID-Token or Insurant-ID mismatch EPA OperationOutcome
404 Health record is in state UNKNOWN or INITIALIZED noHealthRecord (siehe 'Wiederholungsintervalle')
409 Health record is in state SUSPENDED statusMismatch (siehe 'Wiederholungsintervalle')
423 If the insurant objected to the medication process or objected to the submission of prescription and dispensation data into the ePA system, the Medication Service is locked. locked
500 Any other error internalError (siehe 'Wiederholungsintervalle')

Serviceübergreifende Error Codes ohne Verweis auf EPA OperationOutcome MÜSSEN mit dem entsprechenden HTTP Status Code vom Medication Service mit dem Media Type application/json nach folgendem Schema zurückgegeben werden:

{
  "errorCode": "statusMismatch"
}