# 一括ユーザー削除ジョブを取得する

`GET /v1/jobs/user-deletions/{job_id}` · 権限 `users:delete`

[一括ユーザー削除ジョブを作成する](/docs/api/management/jobs/create-user-deletion) で作成したジョブの状態とカウンターを返します。すべてのユーザーに結果が出るまでジョブは `running` で、その後は `completed`（失敗なし）または `completed_with_errors`（`failed` が1件以上）になります。`pending` は結果がまだないユーザー数で、`succeeded + not_found + failed + pending = total` が常に成り立ちます。中断されたジョブ（再起動など）は自動的に再開されます。`status` が `running` でなくなるまでこのエンドポイントを問い合わせてください。

## リクエスト

| パラメータ | 入力 | 必須 | 説明 |
|---|---|---|---|
| `job_id` | path | はい | ジョブID。`job_` で始まります。 |

## レスポンス

`200 OK`。

```json
{
  "id": "job_01h455vb4pex5vsknk084sn02q",
  "status": "completed_with_errors",
  "filter": "organization",
  "organization_id": "org_01h455vb4pex5vsknk084sn02q",
  "total": 3,
  "succeeded": 1,
  "not_found": 1,
  "failed": 1,
  "pending": 0,
  "created_at": "2026-01-15T09:30:00Z",
  "completed_at": "2026-01-15T09:31:00Z"
}
```

## エラー

すべてのエラーは、安定した `code` を含む `application/problem+json` の本文です。

| HTTP | `code` | 情況 |
|---|---|---|
| 401 | `unauthenticated` | APIキーがないか、無効または失効しています。 |
| 403 | `insufficient_permissions` | キーに `users:delete` 権限がありません。 |
| 404 | `not_found` | この環境にジョブがありません（またはIDの形式が不正です）。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` に従ってください。 |
| 503 | `service_unavailable` | 依存サービスが一時的に利用できません。後で再試行してください。 |

## 例

```bash
curl https://api.eu.keenauth.com/v1/jobs/user-deletions/job_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth jobs user-deletions get job_01h455vb4pex5vsknk084sn02q`