# Massen-Passwort-Zurücksetzen-Job abrufen

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

Gibt Status und Zähler eines Jobs zurück, der mit [Massen-Passwort-Zurücksetzen als Job anlegen](/docs/api/management/jobs/create-password-reset) angelegt wurde. Es werden keine personenbezogenen Daten zurückgegeben. `status` durchläuft folgende Werte:

- `marking`: Die ausgewählten Passwörter werden markiert; `marked` steigt.
- `waiting`: nur `lazy_then_bulk_reset`; das Markieren ist abgeschlossen (`marked_at`), und der Job wartet auf `deadline_at`.
- `resetting`: nur `lazy_then_bulk_reset`; die Frist ist abgelaufen, die Passwörter der Benutzer, die sie nicht geändert haben, werden gelöscht (`passwords_deleted`), und für Benutzer mit einer verifizierten primären Adresse wird eine E-Mail zum Zurücksetzen gesendet (`emailed`).
- `completed`: Der Job ist abgeschlossen (`completed_at`). Ein `on_login`-Job wird abgeschlossen, sobald das Markieren fertig ist.

`total` ist die Anzahl verschiedener Benutzer bei einem `user_ids`-Job und `0` bei einem `hash_algo`-Job; `not_found` zählt IDs, die keine Benutzer dieser Umgebung sind oder kein Passwort haben.

## Anfrage

| Parameter | Ort | Pflicht | Beschreibung |
|---|---|---|---|
| `job_id` | Pfad | ja | Job-ID mit dem Präfix `job_`. |

## Antwort

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

## Fehler

Jeder Fehler ist ein `application/problem+json`-Body mit einem stabilen `code`.

| HTTP | `code` | Wann |
|---|---|---|
| 401 | `unauthenticated` | Der API-Schlüssel fehlt, ist ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Dem Schlüssel fehlt die Berechtigung `user-credentials:write`. |
| 404 | `not_found` | Der Job existiert in dieser Umgebung nicht (oder die ID ist fehlerhaft). |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; beachten Sie `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut. |

## Beispiel

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