API

Broadcasts auflisten

Jeder Broadcast in diesem Workspace, der neueste zuerst, Seite für Seite, jeweils mit aktuellen `counts`. `audienceId` behält die, die an diese Audience gingen, allein oder neben anderen.

GETapi.openemail.uk/broadcasts

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

GET /broadcasts

Jeder Broadcast in diesem Workspace, der neueste zuerst, Seite für Seite, jeweils mit aktuellen counts. audienceId behält die, die an diese Audience gingen, allein oder neben anderen.

Beispiel

Benötigt emails:read. limit geht bis 100 und ist standardmäßig 25, und cursor nimmt den nextCursor der vorigen Seite, die ID ihres letzten Broadcasts.

curl

curl "$OE/broadcasts?audienceId=aud_4c1b8e2a7d9f05c36b4e8a71&limit=10" -H "$AUTH"

Antwort

{  "object": "list",  "data": [    {      "object": "broadcast",      "id": "brd_5a8c1e3f7b2d94a06c8e1f3b",      "status": "sending",      "mode": "live",      "source": "api",      "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],      "from": "Acme <[email protected]>",      "subject": "{{firstName|Hello}}, the September release is out",      "counts": {        "recipients": 412,        "created": 250,        "skipped": 1,        "failedToQueue": 0,        "queued": 38,        "sending": 2,        "sent": 209,        "failed": 1,        "cancelled": 0      },      "lastError": null,      "scheduledAt": null,      "startedAt": "2026-09-23T12:00:02.000Z",      "completedAt": null,      "cancelledAt": null,      "createdAt": "2026-09-23T12:00:00.000Z",      "updatedAt": "2026-09-23T12:00:41.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

Die einzelnen Nachrichten stehen nicht hier. Listen Sie die Kopien eines Broadcasts mit GET /emails?broadcastId= auf.

Ein Cursor, der keinen Broadcast in diesem Workspace nennt, ist ein 400 invalid_cursor. Eine audienceId, die keine Audience nennt, liefert eine leere Seite.