> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Termin abrufen

> Einen Blutabnahmetermin anhand der ID abrufen

Rufe einen einzelnen Termin zur Blutabnahme über seine UUID ab, einschließlich des eingebetteten Patientenprofils. Nutze diesen Endpunkt, um den Terminstatus zu prüfen, Termindetails zu bestätigen oder die zugehörigen Profildaten abzurufen.

Erfordert den Scope `appointments_view` oder `appointments_schedule`.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige Kennung (UUID) des abzurufenden Termins.

## Antwort

Bei Erfolg gibt die API `200 OK` mit dem Termin und dem eingebetteten Profil zurück.

**id** `string` *required*

Eindeutige Terminkennung (UUID).

**profile\_id** `string` *required*

UUID des Profils, zu dem dieser Termin gehört.

**location\_id** `string`

UUID des Teststandorts, an dem die Blutabnahme stattfindet.

**scheduled\_at** `string`

Geplanter Terminzeitpunkt in UTC (ISO 8601 mit `Z`-Suffix, z. B.
`2026-05-15T10:30:00Z`). Kann `null` sein.

**status** `string` *required*

Aktueller Terminstatus. Einer von `pending`, `confirmed`, `blood_drawn` oder `cancelled`. Wie
vollständig die Laborergebnisse sind, ergibt sich aus [Ergebnisse
abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md); den genaueren Versandverlauf siehst du über jeden Eintrag
im eingebetteten `shipments`-Array (siehe unten) in Kombination mit [Sendung
abrufen](https://docs.anivahealth.com/de/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Freitextgrund, der bei der Stornierung des Termins erfasst wurde (z. B. Nichterscheinen, späte Stornierung,
'Fehlgeschlagen. Wiederholung erforderlich'). `null`, sofern `status` nicht `cancelled` ist.

**results\_ready\_emails** `string[]` *required*

Adressen in Kleinbuchstaben, die jeweils eine E-Mail erhalten, sobald alle Laborergebnisse final sind. Leer, wenn deaktiviert. Siehe
[E-Mails bei fertigen Ergebnissen](https://docs.anivahealth.com/de/concepts/results.md#e-mails-bei-fertigen-ergebnissen).

**draw\_method** `string` *required*

Art der Blutabnahme: `capillary` (aus der Fingerkuppe oder dem Oberarm, in Microtainer) oder `venous` (aus der Vene,
in Röhrchen). Entspricht der im Termin festgelegten Methode, sonst der `default_draw_method` des
[Standorts](https://docs.anivahealth.com/de/concepts/locations.md). Nach der Blutabnahme ist es die verwendete Methode.

**created\_at** `string` *required*

ISO-8601-Zeitstempel der Erstellung des Termins.

**updated\_at** `string`

ISO-8601-Zeitstempel der letzten Aktualisierung. Kann `null` sein.

**profile** `object` *required*

Das mit diesem Termin verknüpfte Patientenprofil.

**Profil**

**id** `string`

Eindeutige Profilkennung (UUID).

**handle** `string`

Profil-Handle oder Benutzername. Kann `null` sein.

**first\_name** `string`

Vorname. Kann `null` sein.

**last\_name** `string`

Nachname. Kann `null` sein.

**email** `string`

E-Mail-Adresse. Kann `null` sein.

**phone** `string`

Telefonnummer im E.164-Format. Kann `null` sein.

**sex** `integer`

Biologisches Geschlecht nach ISO/IEC 5218. Kann `null` sein.

**date\_of\_birth** `string`

Geburtsdatum im Format `YYYY-MM-DD`. Kann `null` sein.

**height** `number`

Körpergröße in Zentimetern. Kann `null` sein.

**weight** `number`

Gewicht in Kilogramm. Kann `null` sein.

**language** `string`

Bevorzugte Sprache: einer der 32 Codes unter [Profil erstellen](https://docs.anivahealth.com/de/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Ob dieses Profil transaktionale (programmatische) E-Mails erhält. Kann `null` sein.

**created\_at** `string`

ISO-8601-Zeitstempel der Erstellung des Profils.

**updated\_at** `string`

ISO-8601-Zeitstempel der letzten Profilaktualisierung. Kann `null` sein.

**panels** `AppointmentPanel[]` *required*

Panels, die derzeit diesem Termin zugeordnet sind. Stornierte Zuordnungen sind ausgeschlossen. Panel-Details
(Name, Biomarker) findest du über [Panels auflisten](https://docs.anivahealth.com/de/api/panels/list-panels.md).

**Felder der Panel-Verknüpfung**

**panel\_id** `string`

Panel-UUID – Abgleich über [Panels auflisten](https://docs.anivahealth.com/de/api/panels/list-panels.md).

**added\_at** `string`

ISO-8601-Zeitstempel, zu dem das Panel erstmals mit diesem Termin verknüpft wurde.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Einzel-Biomarker, die außerhalb eines Panels mit diesem Termin verknüpft sind (siehe [Eigene
Biomarker hinzufügen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md)). Gleiche jede `biomarker_id`
für Anzeigedaten mit [Biomarker auflisten](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md) ab.

**Felder für Einzel-Biomarker**

**biomarker\_id** `integer`

Biomarker-Kennung – Abgleich über
[Biomarker auflisten](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO-8601-Zeitstempel, zu dem der Biomarker erstmals mit diesem Termin verknüpft wurde.

**shipments** `AppointmentShipmentLink[]` *required*

Sendungen, die mit diesem Termin verknüpft sind, älteste Verknüpfung zuerst. Leeres Array, wenn keine Sendungen
verknüpft sind. Gleiche jede `id` mit [Sendung abrufen](https://docs.anivahealth.com/de/api/shipments/get-shipment.md) ab, um die
vollständigen Sendungsdaten (Status, Sendungsnummer, Statusaktualisierungen usw.) zu erhalten.

**Felder der Sendungsverknüpfung**

**id** `string`

Referenzkennung der Sendung – Abgleich über
[Sendung abrufen](https://docs.anivahealth.com/de/api/shipments/get-shipment.md).

**added\_at** `string`

ISO-8601-Zeitstempel, zu dem die Sendung erstmals mit diesem Termin verknüpft wurde.

**lab\_codes** `string[]` *required*

Laborcodes (Röhrchen-Barcodes), die für diesen Termin erfasst wurden, in Scan-Reihenfolge. Leer, bis die Blutabnahme
bestätigt wird. Eine venöse Blutabnahme hat einen Code, der auf jedem Röhrchen steht; eine kapillare Blutabnahme hat einen
Code pro Microtainer. Ergebnisse und Dokumente unter [Ergebnisse abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md) verweisen
über `lab_code` auf diese Codes.

## Wiederholte Aufrufe

Aniva speichert die Antwort dieses Endpunkts 15 Minuten lang für jeden API-Schlüssel. Ein wiederholter Aufruf innerhalb
dieser Zeit erhält die gespeicherte Antwort, solange der Termin unverändert bleibt. Nach einer Änderung erhältst du eine aktuelle
Antwort. Die Header `Cache-Status` und `Age` zeigen an, dass die Antwort
gespeichert ist und wie alt sie ist.

Um sofort von einer Änderung zu erfahren, abonniere die Webhook-Events `appointment.created`, `appointment.rescheduled` sowie das Event für jeden Status, zum Beispiel `appointment.confirmed`.
Siehe [Wiederholte Abrufe](https://docs.anivahealth.com/de/concepts/webhooks.md#wiederholte-abrufe).

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Ungültiges ID-Format – der angegebene Wert ist keine gültige UUID. |
| `403` | Zugriff verweigert – dein API-Schlüssel ist für diesen Vorgang nicht berechtigt. |
| `404` | Termin nicht gefunden. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [
    {
      "biomarker_id": 42,
      "added_at": "2026-04-01T09:52:00Z"
    }
  ],
  "shipments": [
    {
      "id": "P2611194821",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "lab_codes": []
}
```

```json 400 theme={null}
{
  "error": "Invalid appointment ID format"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.