
# 일괄 비밀번호 재설정 작업 조회

`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의 수입니다.

## 요청

| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
| `job_id` | path | 예 | `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`
