ドキュメント本文へスキップ
API

オーディエンスを取得する

一覧の 1 行と同じ形で、`contactCount` は最新の値になります。背後の連絡先を取得せずに件数の変化を追う、軽量な方法です。

GETapi.openemail.uk/audiences/{id}

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

GET /audiences/{id}

一覧の 1 行と同じ形で、contactCount は最新の値になります。背後の連絡先を取得せずに件数の変化を追う、軽量な方法です。

audiences:read が必要です。

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH"
レスポンス
{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Product updates",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 3,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:10:00.000Z"}

別のワークスペースの id は 403 ではなく 404 になります。この API は、見る権限のない場所に何かが存在することを決して伝えません。

デフォルトオーディエンスもここでは他と同じように読め、その builtindefault です。