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

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

一括パスワードリセットジョブを作成するで作成したジョブのステータスとカウンターを返します。個人データは返されません。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。

{
  "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`	依存先のサービスが一時的に利用できません。後で再試行してください。

例

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