---
title: "Abonnenten einer Status-Seite auflisten"
description: "Gibt die E-Mail- und RSS-Abonnenten einer Status-Seite zurück, dazu exakte Zählwerte je Status. Erfordert Admin- oder Editor-Rolle."
---

`GET /api/status-pages/:id/subscribers`

## Pfad-Parameter

| Parameter | Beschreibung |
|-----------|-------------|
| `id` | Status-Seiten-ID oder `publicId` (UUID) |

## Beispiel (cURL)

```bash
curl "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/subscribers" \
  -H "Authorization: Bearer $TOKEN"
```

## Antwort

```json
{
  "total": 12,
  "confirmed": 9,
  "pending": 2,
  "unsubscribed": 1,
  "subscribers": [
    {
      "id": 42,
      "email": "reader@example.com",
      "status": "confirmed",
      "locale": "en",
      "createdAt": "2026-08-01T12:00:00.000Z",
      "confirmedAt": "2026-08-01T12:05:00.000Z"
    }
  ]
}
```

`status` ist entweder `pending`, `confirmed` oder `unsubscribed`. `confirmedAt` ist `null`, bis der Abonnent seine Adresse bestätigt hat. `total`, `confirmed`, `pending` und `unsubscribed` sind exakte Zählwerte, unabhängig vom `subscribers`-Array berechnet; `subscribers` selbst ist auf 5000 Zeilen begrenzt, neueste zuerst, nutze [Abonnenten exportieren](./export-subscribers) für die vollständige Liste bei größeren Seiten.

## Häufige Fehler

- `401 Unauthorized`, wenn du nicht authentifiziert bist
- `400 User must belong to an organization` (`data.code: userMustBelongToOrg`), wenn sich aus Session oder Token keine Organisation ableiten lässt
- `403 Forbidden`, wenn deine Rolle nicht Admin oder Editor ist, oder dein Kunden-Scope diese Status-Seite nicht einschließt
- `400 Invalid Status page identifier`, wenn `id` keine gültige numerische ID oder UUID ist (kein `data.code`)
- `404 Status page not found`, wenn `id` wohlgeformt ist, aber keine Status-Seite dazu existiert (kein `data.code`)
- `404 Status page not found` (`data.code: statusPageNotFound`), wenn `id` sich zu einer echten Status-Seite auflöst, diese aber zu einer anderen Organisation gehört oder außerhalb deines Kunden-Scopes liegt

Die letzten beiden Zeilen teilen sich dieselbe Meldung, unterscheiden sich aber im `data.code`: eine fehlerhafte oder gänzlich unbekannte `id` trägt nie einen `data.code`; nur eine `id`, die sich zu einer Zeile auflöst, die du nicht sehen darfst, tut das.