Abonnements auflisten
Die Newsletter und Mailinglisten, die das Postfach empfängt, so wie die Seite „Abonnements“ sie zeigt.
Führt den echten Aufruf in Ihrem Workspace aus.
GET /subscriptions
Die Newsletter und Mailinglisten, die das Postfach empfängt, so wie die Seite „Abonnements“ sie zeigt.
Beispiel
Erfordert threads:read. Ein Absender ist ein Abonnement, wenn seine Mail einen List-Unsubscribe-Header trägt, mit einer Zeile für jede Adresse, an die er schreibt. status ist active, der Standard, oder unsubscribed, q durchsucht den Absender, und sort ist recent, most, unread oder name.
curl "$OE/subscriptions?sort=most&limit=1" -H "$AUTH"{ "object": "list", "data": [{ "object": "subscription", "id": "sub_5d2c8e17", "senderEmail": "[email protected]", "senderName": "Figma", "recipient": "[email protected]", "status": "active", "method": "one-click", "linkUrl": "https://www.figma.com/unsubscribe?u=4f1c", "unread": 12, "recent": 4, "total": 58, "sinceUnsubscribed": 0, "lastSeenAt": "2026-10-01T07:02:41.000Z", "unsubscribedAt": null, "unsubscribedWith": null, "future": null }], "total": 37, "counts": { "active": 37, "unsubscribed": 9 }, "hasMore": true}recent zählt die Mail der letzten 30 Tage, sinceUnsubscribed die Mail, die nach Ihrer Abmeldung noch eingetroffen ist, und future nennt die Regel, die seine neue Mail weiter verschiebt, falls es eine gibt.
limit (50, sofern Sie nichts anderes sagen, höchstens 200) und offset blättern durch sie. total zählt jede passende Zeile, und counts, wie viele aktiv und wie viele abgemeldet sind.
Ein Schlüssel oder eine App, die auf bestimmte Adressen beschränkt ist, listet nur die Abonnements auf, die an diese Adressen zugestellt werden, und address grenzt das auf eine Adresse ein.