Uptimeify Docs

Abonnenten aller Statusseiten auflisten

Liefert die Abonnenten aller Statusseiten, die du verwalten darfst, in einer gefilterten, seitenweisen Liste. Erfordert Admin- oder Editor-Rolle.

GET /api/status-pages/subscribers

Dieselben Zeilen wie Abonnenten auflisten, über alle Seiten: genau die Statusseiten, deren Abonnentenliste du auch einzeln öffnen dürftest (deine Organisation, dein Kundenumfang; Seiten ohne Kunde nur mit organisationsweitem Umfang). Anlegen lassen sich Abonnenten über die API nicht: ein Abonnement entsteht erst, wenn der Empfänger es bestätigt hat (Double-Opt-in). Zum Entfernen dient Abonnent löschen mit der statusPagePublicId der Zeile.

Query-Parameter

ParameterBeschreibung
pageSeitennummer, Vorgabe 1
perPageZeilen je Seite, Vorgabe 50, höchstens 200
statusPageIdNur diese Statusseite (ID oder publicId). Eine unbekannte Seite oder eine außerhalb deines Umfangs ergibt eine leere Liste
channelemail, sms, push, webhook, slack oder teams
statuspending, confirmed, unsubscribed oder disabled
searchSucht ohne Beachtung der Groß-/Kleinschreibung in E-Mail-Adresse und Name der Statusseite (höchstens 200 Zeichen)

Beispiel (cURL)

curl "$BASE_URL/api/status-pages/subscribers?status=confirmed&perPage=100" \
  -H "Authorization: Bearer $TOKEN"

Antwort

{
  "items": [
    {
      "id": 43,
      "statusPageId": 7,
      "statusPagePublicId": "db58058e-4b58-4d97-a314-3bb8e279a182",
      "statusPageName": "Acme Status",
      "email": null,
      "channel": "slack",
      "target": "https://hooks.slack.com/…",
      "componentIds": [12],
      "componentNames": ["Checkout"],
      "status": "confirmed",
      "locale": "de",
      "createdAt": "2026-10-27T09:00:00.000Z",
      "confirmedAt": "2026-10-27T09:01:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 100
}

Neueste zuerst. Die Felder bedeuten dasselbe wie bei Abonnenten auflisten: email ist bei den URL-Kanälen null, target enthält nur den Ursprung der Ziel-URL, nie die ganze URL. componentNames nennt die Namen zu componentIds in derselben Reihenfolge; beide sind null, wenn der Abonnent der ganzen Seite folgt.

Häufige Fehler

  • 401 Unauthorized, wenn du nicht angemeldet bist
  • 403 Forbidden (data.code: forbidden), wenn deine Rolle weder Admin noch Editor ist
  • 403 Forbidden (data.code: statusPagesModuleDisabled), wenn das Statusseiten-Modul für deine Organisation nicht aktiv ist
  • 400 Bad Request (data.code: invalidRequestBody), wenn page, perPage, channel, status oder search ungültig ist
  • 400 Invalid Status page identifier (data.code: invalidIdentifier), wenn statusPageId weder numerische ID noch UUID ist

Auf dieser Seite