# 일괄 사용자 삭제 작업 조회

`GET /v1/jobs/user-deletions/{job_id}` · 권한 `users:delete`

[일괄 사용자 삭제 작업 생성](/docs/api/management/jobs/create-user-deletion)으로 만든 작업의 상태와 카운터를 반환합니다. 모든 사용자가 결과를 가질 때까지 작업은 `running`이며, 그 뒤에는 `completed`(실패 없음) 또는 `completed_with_errors`(`failed`가 하나 이상)가 됩니다. `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`