# Obtenir un utilisateur d'annuaire

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

Renvoie un enregistrement utilisateur actif de l'annuaire, avec les mêmes champs que [Lister les utilisateurs de l'annuaire](list-users.md). Sans l'autorisation `users:read_pii`, les données personnelles sont masquées de la même manière et `attributes` vaut `null`.

## Requête

| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| `directory_id` | path | oui | Identifiant de l'annuaire SCIM (`dir_…`). |
| `directory_user_id` | path | oui | Identifiant de l'utilisateur d'annuaire (`dsu_…`). |

Il n'y a pas de corps de requête.

## Réponse

`200 OK` avec l'utilisateur d'annuaire.

```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"
}
```

L'exemple montre une réponse à un identifiant sans `users:read_pii`.

## Erreurs

| HTTP | code | Quand |
|---|---|---|
| 404 | `not_found` | L'annuaire ou l'enregistrement utilisateur n'existe pas dans cet environnement, appartient à un autre annuaire ou a été supprimé. |
| 401 | `unauthenticated` | L'identifiant est absent, invalide ou révoqué. |
| 403 | `insufficient_permissions` | L'identifiant ne dispose pas de l'autorisation requise. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; réessayez après la période indiquée par `Retry-After`. |
| 503 | `service_unavailable` | La synchronisation de l'annuaire est temporairement indisponible ou non configurée dans ce déploiement ; réessayez après la période indiquée par `Retry-After`. |

## Exemple

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

## Données personnelles

Cet endpoint traite des données personnelles : des utilisateurs d'annuaire (SCIM). [Données personnelles dans les API KeenAuth](/docs/policies/personal-data) décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. Ne transmettez pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.