# 一括パスワードリセットジョブを取得する

`GET /v1/jobs/password-resets/{job_id}` · 権限 `user-credentials:write`

[一括パスワードリセットジョブを作成する](/docs/api/management/jobs/create-password-reset) で作成したジョブのステータスとカウンターを返します。個人データは返されません。`status` は次の順に遷移します:

- `marking`: 選択されたパスワードにフラグを付けています。`marked` が増えていきます。
- `waiting`: `lazy_then_bulk_reset` のみ。フラグ付けは完了しており（`marked_at`）、ジョブは `deadline_at` を待っています。
- `resetting`: `lazy_then_bulk_reset` のみ。期限を過ぎており、まだパスワードを変更していないユーザーのパスワードを削除しています（`passwords_deleted`）。確認済みのプライマリメールアドレスを持つユーザーには、リセットメールを送信しています（`emailed`）。
- `completed`: ジョブは完了しています（`completed_at`）。`on_login` ジョブは、フラグ付けが完了するとすぐに完了します。

`total` は `user_ids` ジョブの場合は異なるユーザーの数、`hash_algo` ジョブの場合は `0` です。`not_found` は、この環境のユーザーではない ID、またはパスワードのない ID を数えます。

## リクエスト

| パラメーター | 場所 | 必須 | 説明 |
|---|---|---|---|
| `job_id` | パス | はい | `job_` で始まるジョブ ID です。 |

## レスポンス

`200 OK`。

```json
{
  "id": "job_01h455vb4pex5vsknk084sn02q",
  "mode": "on_login",
  "filter": "user_ids",
  "status": "completed",
  "total": 3,
  "marked": 2,
  "not_found": 1,
  "passwords_deleted": 0,
  "emailed": 0,
  "created_at": "2026-01-15T09:30:00Z",
  "marked_at": "2026-01-15T09:31:00Z",
  "completed_at": "2026-01-15T09:31:00Z"
}
```

## エラー

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

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

## 例

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

CLI: `keenauth jobs password-resets get job_01h455vb4pex5vsknk084sn02q`