API

一斉配信のコピーを 1 通取得する

一人分のコピーです。`GET /broadcasts/{id}/recipients` が一覧するのと同じ行に加え、その人が受け取ったとおりの件名、HTML、テキストを、差し込みフィールドを埋め、その人専用の登録解除リンクを付けた状態で返します。

GETapi.openemail.uk/broadcasts/{id}/recipients/{emailId}

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

GET /broadcasts/{id}/recipients/{emailId}

一人分のコピーです。GET /broadcasts/{id}/recipients が一覧するのと同じ行に加え、その人が受け取ったとおりの件名、HTML、テキストを、差し込みフィールドを埋め、その人専用の登録解除リンクを付けた状態で返します。

例

emails:read が必要です。emailId は受信者一覧から得たコピーの emailId です。ここでは応答を省略しています。

curl

curl "$OE/broadcasts/brd_5a8c1e3f7b2d94a06c8e1f3b/recipients/msg_01dad25067bc4dac966d515d" -H "$AUTH"

レスポンス

{  "object": "broadcast_recipient",  "emailId": "msg_01dad25067bc4dac966d515d",  "email": "[email protected]",  "name": "Ada Lovelace",  "status": "sent",  "deliveredAt": "2026-09-23T12:00:11.000Z",  "opens": 3,  "clicks": 1,  "unsubscribedAt": null,  "subject": "Ada, the September release is out",  "html": "<p>Hi Ada,</p><p>Here is what changed this month.</p>",  "text": "Hi Ada, here is what changed this month. Unsubscribe: https://…"}

HTML は開封とクリックのトラッキングを追加する前のものです。つまり、差し込みフィールドを埋めた、あなたが書いたとおりの内容であり、トラッキングピクセルと書き換えたリンクを含んだ実際のバイト列ではありません。

この一斉配信のコピーではない emailId は、ワークスペース内の別のメールを指していても 404 recipient_not_found になります。

拒否

ステータス	コード	発生条件
400	`invalid_cursor`	受信者一覧で、その一覧が渡していない `cursor` が指定された場合。
403	`insufficient_scope`	キーが `emails:read` を持っていません。
404	`broadcast_not_found`	id がこのワークスペースのどの一斉配信も指していないか、キーが特定のアドレスやドメインに限定されていて、その一斉配信がキーの持たないアドレスから送られています。
404	`recipient_not_found`	`GET /broadcasts/{id}/recipients/{emailId}` で、この一斉配信のコピーではない `emailId` が指定された場合。