# Verzeichnisbenutzer abrufen

`GET /v1/directories/{directory_id}/users/{directory_user_id}` · Berechtigung `directories:read`

Gibt einen aktiven Benutzerdatensatz des Verzeichnisses zurück, mit denselben Feldern wie [Verzeichnisbenutzer auflisten](list-users.md). Ohne die Berechtigung `users:read_pii` werden die personenbezogenen Daten auf die gleiche Weise maskiert, und `attributes` ist `null`.

## Anfrage

| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| `directory_id` | path | ja | SCIM-Verzeichniskennung (`dir_…`). |
| `directory_user_id` | path | ja | Kennung des Verzeichnisbenutzers (`dsu_…`). |

Es gibt keinen Anfragetext.

## Antwort

`200 OK` mit dem Verzeichnisbenutzer.

```json
{
  "id": "dsu_01j9xp4q6r8s0t2v4w6x8y0z2b",
  "directory_id": "dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
  "external_id": "00u1a2b3c4",
  "user_name": "j***",
  "emails": [{ "value": "j***@e***.com", "primary": true }],
  "given_name": "J.",
  "family_name": "D.",
  "display_name": "J. D.",
  "locale": "en-US",
  "zoneinfo": "Europe/Berlin",
  "state": "inactive",
  "attributes": null,
  "groups": [],
  "user_id": null,
  "link_status": "unlinked",
  "drift": false,
  "created_at": "2026-10-20T09:00:00Z",
  "updated_at": "2026-10-20T09:05:00Z"
}
```

Das Beispiel zeigt eine Antwort auf Anmeldedaten ohne `users:read_pii`.

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 404 | `not_found` | Das Verzeichnis oder der Benutzerdatensatz existiert in dieser Umgebung nicht, gehört zu einem anderen Verzeichnis oder wurde gelöscht. |
| 401 | `unauthenticated` | Die Anmeldedaten fehlen, sind ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Die Anmeldedaten haben nicht die erforderliche Berechtigung. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeitspanne `Retry-After`. |
| 503 | `service_unavailable` | Die Verzeichnissynchronisierung ist vorübergehend nicht verfügbar oder in dieser Bereitstellung nicht konfiguriert; wiederholen Sie die Anfrage nach der Zeitspanne `Retry-After`. |

## Beispiel

```bash
curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/users/dsu_01j9xp4q6r8s0t2v4w6x8y0z2b" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Verzeichnisbenutzer (SCIM). [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).