# Obtenir une tâche de réinitialisation du mot de passe en masse

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

Renvoie le statut et les compteurs d'une tâche créée avec [Créer une tâche de réinitialisation du mot de passe en masse](/docs/api/management/jobs/create-password-reset). Aucune donnée personnelle n'est renvoyée. `status` passe par les étapes suivantes :

- `marking` : les mots de passe sélectionnés sont en cours de signalement ; `marked` augmente.
- `waiting` : `lazy_then_bulk_reset` uniquement ; le signalement est terminé (`marked_at`) et la tâche attend `deadline_at`.
- `resetting` : `lazy_then_bulk_reset` uniquement ; l'échéance est passée et les mots de passe des utilisateurs qui ne les ont pas modifiés sont en cours de suppression (`passwords_deleted`), avec un e-mail de réinitialisation pour ceux qui ont une adresse principale vérifiée (`emailed`).
- `completed` : la tâche est terminée (`completed_at`). Une tâche `on_login` se termine dès que le signalement est terminé.

`total` est le nombre d'utilisateurs distincts pour une tâche `user_ids` et `0` pour une tâche `hash_algo` ; `not_found` compte les identifiants qui ne sont pas des utilisateurs de cet environnement ou qui n'ont pas de mot de passe.

## Demande

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

## Réponse

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

## 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 possède pas l'autorisation `user-credentials:write`. |
| 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/password-resets/job_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI : `keenauth jobs password-resets get job_01h455vb4pex5vsknk084sn02q`