Aller à la documentation
API

Lister les diffusions

Chaque diffusion de cet espace de travail, de la plus récente à la plus ancienne, une page à la fois, chacune avec des `counts` à jour. `audienceId` garde celles envoyées à cette audience, seule ou avec d'autres.

GETapi.openemail.uk/broadcasts

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

GET /broadcasts

Chaque diffusion de cet espace de travail, de la plus récente à la plus ancienne, une page à la fois, chacune avec des counts à jour. audienceId garde celles envoyées à cette audience, seule ou avec d'autres.

Exemple

Exige emails:read. limit va jusqu'à 100 et vaut 25 par défaut, et cursor prend le nextCursor de la page précédente, l'identifiant de sa dernière diffusion.

curl
curl "$OE/broadcasts?audienceId=aud_4c1b8e2a7d9f05c36b4e8a71&limit=10" -H "$AUTH"
Réponse
{  "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}

Les messages individuels ne sont pas ici. Listez les copies d'une diffusion avec GET /emails?broadcastId=.

Un curseur qui ne désigne aucune diffusion de cet espace de travail donne un 400 invalid_cursor. Un audienceId qui ne désigne aucune audience renvoie une page vide.