दस्तावेज़ पर जाएँ
API

broadcasts की सूची

इस वर्कस्पेस का हर broadcast, सबसे नया पहले, एक बार में एक पेज, हर एक के साथ ताज़ा `counts`। `audienceId` उन्हें रखता है जो उस ऑडियंस को भेजे गए, अकेले या दूसरों के साथ।

GETapi.openemail.uk/broadcasts

असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।

GET /broadcasts

इस वर्कस्पेस का हर broadcast, सबसे नया पहले, एक बार में एक पेज, हर एक के साथ ताज़ा countsaudienceId उन्हें रखता है जो उस ऑडियंस को भेजे गए, अकेले या दूसरों के साथ।

उदाहरण

emails:read चाहिए। limit 100 तक जाता है और डिफ़ॉल्ट 25 है, और cursor पिछले पेज का nextCursor लेता है, यानी उसके आख़िरी broadcast का id।

curl
curl "$OE/broadcasts?audienceId=aud_4c1b8e2a7d9f05c36b4e8a71&limit=10" -H "$AUTH"
प्रतिक्रिया
{  "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}

अलग-अलग संदेश यहाँ नहीं हैं। किसी broadcast की कॉपियाँ GET /emails?broadcastId= से सूचीबद्ध करें।

जो cursor इस वर्कस्पेस के किसी broadcast का नाम नहीं देता वह 400 invalid_cursor है। जो audienceId किसी ऑडियंस का नाम नहीं देता वह ख़ाली पेज लौटाता है।