# ディレクトリユーザーを取得

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

ディレクトリ内の有効なユーザーレコードを 1 件返します。フィールドは [ディレクトリユーザーの一覧取得](list-users.md) と同じです。`users:read_pii` 権限がない場合、個人データは同様にマスクされ、`attributes` は `null` になります。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `directory_id` | path | はい | SCIM ディレクトリの ID（`dir_…`）。 |
| `directory_user_id` | path | はい | ディレクトリユーザーの ID（`dsu_…`）。 |

リクエストボディはありません。

## レスポンス

ディレクトリユーザーを含む `200 OK`。

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

この例は、`users:read_pii` のない認証情報に対するレスポンスを示しています。

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 404 | `not_found` | ディレクトリまたはユーザーレコードがこの環境に存在しないか、別のディレクトリに属しているか、削除されています。 |
| 401 | `unauthenticated` | 認証情報がないか、無効または取り消されています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間を過ぎてから再試行してください。 |
| 503 | `service_unavailable` | ディレクトリの同期が一時的に利用できないか、このデプロイメントで構成されていません。`Retry-After` の期間を過ぎてから再試行してください。 |

## 例

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

## 個人データ

このエンドポイントは個人データ（ディレクトリ（SCIM）のユーザー）を扱います。[KeenAuth API の個人データ](/docs/policies/personal-data)では、保存される内容、保持期間、削除方法について説明しています。どのフィールドにも、特別な種類の個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。