Deutsch English

Abonnenten auflisten

GET /api/v1/subscribers

Adressen sind immer maskiert. Für die gezielte Suche den E-Mail-Filter nutzen: Er löst über den gespeicherten Hash auf und gibt nie eine Adresse zurück.

Erforderliche Berechtigung

subscribers.manage Abonnenten verwalten

Body Parameter (application/json)

Name Format Beschreibung Optional
page integer
per_page integer Wird auf die maximale Seitengröße begrenzt statt abgewiesen.
email string Exakte Adresse, nach der gesucht wird.
confirmed boolean

Response (application/json)

200 
{3 Eigenschaften
  "links": {4 Eigenschaften
    "first": "https://status.example.com/api/v1/subscribers?page=1",
    "last": "https://status.example.com/api/v1/subscribers?page=1",
    "prev": null,
    "next": null
  },
  "meta": {4 Eigenschaften
    "current_page": 1,
    "per_page": 25,
    "total": 1,
    "last_page": 1
  },
  "data": [1 Element
    {9 Eigenschaften
      "id": 87,
      "email_masked": "an***@example.com",
      "locale": "de",
      "channel": "email",
      "confirmed": true,
      "confirmed_at": "2026-06-02T09:31:00Z",
      "subscribe_all_components": false,
      "component_ids": [2 Elemente
        3,
        4
      ],
      "created_at": "2026-06-02T09:28:00Z"
    }
  ]
}

cURL

curl -X GET 'https://status.example.com/api/v1/subscribers' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY'