# Obtener un usuario de directorio

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

Devuelve un registro activo de usuario del directorio, con los mismos campos que [Listar usuarios del directorio](list-users.md). Sin el permiso `users:read_pii`, los datos personales se enmascaran de la misma forma y `attributes` es `null`.

## Solicitud

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `directory_id` | path | sí | Identificador del directorio SCIM (`dir_…`). |
| `directory_user_id` | path | sí | Identificador del usuario del directorio (`dsu_…`). |

No hay cuerpo de solicitud.

## Respuesta

`200 OK` con el usuario del directorio.

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

El ejemplo muestra una respuesta para una credencial sin `users:read_pii`.

## Errores

| HTTP | code | Cuándo |
|---|---|---|
| 404 | `not_found` | El directorio o el registro del usuario no existe en este entorno, pertenece a otro directorio o ha sido eliminado. |
| 401 | `unauthenticated` | La credencial falta, no es válida o ha sido revocada. |
| 403 | `insufficient_permissions` | La credencial no tiene el permiso necesario. |
| 429 | `rate_limited` | Se ha superado el límite de uso; reintente después del periodo indicado en `Retry-After`. |
| 503 | `service_unavailable` | La sincronización de directorios no está disponible temporalmente o no está configurada en este despliegue; reintente después del periodo indicado en `Retry-After`. |

## Ejemplo

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

## Datos personales

Este endpoint trata datos personales: usuarios de directorios (SCIM). [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, cuánto tiempo se conserva y cómo se eliminan. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.