API

브로드캐스트 목록

이 워크스페이스의 모든 브로드캐스트를 최신순으로 한 페이지씩, 각각 실시간 `counts`와 함께 가져옵니다. `audienceId`는 그 오디언스로 보낸 것만, 단독이든 다른 것과 함께든 남깁니다.

GETapi.openemail.uk/broadcasts

본인 키로 워크스페이스에 실제 호출을 실행합니다.

GET /broadcasts

이 워크스페이스의 모든 브로드캐스트를 최신순으로 한 페이지씩, 각각 실시간 counts와 함께 가져옵니다. audienceId는 그 오디언스로 보낸 것만, 단독이든 다른 것과 함께든 남깁니다.

예시

emails:read가 필요합니다. limit은 최대 100, 기본값 25이고, cursor는 이전 페이지의 nextCursor, 즉 그 페이지 마지막 브로드캐스트의 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}

개별 메시지는 여기 없습니다. 브로드캐스트 하나의 사본은 GET /emails?broadcastId=로 나열하세요.

이 워크스페이스의 어떤 브로드캐스트도 가리키지 않는 커서는 400 invalid_cursor입니다. 어떤 오디언스도 가리키지 않는 audienceId는 빈 페이지를 돌려줍니다.