پرش به مستندات
API

فهرست ارسال‌های گروهی

همهٔ ارسال‌های گروهی این فضای کاری، تازه‌ترین اول، صفحه به صفحه، هر کدام با `counts` زنده. `audienceId` آن‌هایی را نگه می‌دارد که برای آن گروه رفته‌اند، به‌تنهایی یا کنار گروه‌های دیگر.

GETapi.openemail.uk/broadcasts

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

GET /broadcasts

همهٔ ارسال‌های گروهی این فضای کاری، تازه‌ترین اول، صفحه به صفحه، هر کدام با counts زنده. audienceId آن‌هایی را نگه می‌دارد که برای آن گروه رفته‌اند، به‌تنهایی یا کنار گروه‌های دیگر.

نمونه

به emails:read نیاز دارد. limit تا ۱۰۰ می‌رود و پیش‌فرضش ۲۵ است، و cursor مقدار nextCursor صفحهٔ قبل را می‌گیرد، یعنی شناسهٔ آخرین ارسال گروهی آن.

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}

پیام‌های تکی اینجا نیستند. نسخه‌های یک ارسال گروهی را با GET /emails?broadcastId= فهرست کنید.

مکان‌نمایی که هیچ ارسال گروهی‌ای را در این فضای کاری نام نبرد 400 invalid_cursor است. audienceIdی که هیچ گروهی را نام نبرد صفحه‌ای خالی برمی‌گرداند.