# Obtenir une tâche de suppression d'utilisateurs en masse

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

Renvoie l'état et les compteurs d'une tâche créée avec [Créer une tâche de suppression d'utilisateurs en masse](/docs/api/management/jobs/create-user-deletion). La tâche est `running` jusqu'à ce que chaque utilisateur ait un résultat, puis `completed` (aucun échec) ou `completed_with_errors` (au moins un `failed`). `pending` est le nombre d'utilisateurs sans résultat pour l'instant ; `succeeded + not_found + failed + pending = total`. Une tâche interrompue (par exemple par un redémarrage) continue d'elle-même ; interrogez ce point de terminaison jusqu'à ce que `status` ne soit plus `running`.

## Demande

| Paramètre | Dans | Obligatoire | Description |
|---|---|---|---|
| `job_id` | path | oui | Identifiant de la tâche, préfixé `job_`. |

## Réponse

`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"
}
```

## Erreurs

Chaque erreur est un corps `application/problem+json` avec un `code` stable.

| HTTP | `code` | Quand |
|---|---|---|
| 401 | `unauthenticated` | La clé d'API est absente, invalide ou révoquée. |
| 403 | `insufficient_permissions` | La clé ne dispose pas de l'autorisation `users:delete`. |
| 404 | `not_found` | La tâche n'existe pas dans cet environnement (ou l'identifiant est mal formé). |
| 429 | `rate_limited` | La limite de débit a été dépassée ; respectez `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez plus tard. |

## Exemple

```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`