> ## 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.

# Profil abrufen

> Ein Patientenprofil anhand der ID abrufen

Rufe ein einzelnes Patientenprofil anhand seiner UUID ab. Nutze diesen Endpunkt, um demografische Daten nachzuschlagen oder zu prüfen, ob ein Profil existiert, bevor du einen Termin buchst.

Erfordert den Scope `profiles_view` oder `impersonate`.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige ID (UUID) des abzurufenden Profils.

## Antwort

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

**id** `string` *required*

Eindeutige Profil-ID (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 (`0` = unbekannt, `1` = männlich, `2` = weiblich). 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: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` oder `uk`.

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

Ob dieses Profil transaktionale (programmatische) E-Mails erhält. `null`, wenn noch nie gesetzt.

**created\_at** `string`

ISO-8601-Zeitstempel der Profilerstellung.

**updated\_at** `string`

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

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Ungültiges ID-Format – der angegebene Wert ist keine gültige UUID. |
| `403` | Zugriff verweigert – dein API-Key hat keinen Zugriff auf diese Operation oder das Profil liegt außerhalb deines Zugriffskontexts. |
| `404` | Profil nicht gefunden. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "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": "2026-04-01T11:05:00Z"
}
```

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

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


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