Skip to main content
GET
/
v1
/
automations
/
audience-runs
List manual-audience runs
curl --request GET \
  --url https://brew.new/api/v1/automations/audience-runs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "audienceRunId": "arun_01HZ",
      "automationId": "auto_abc",
      "audienceId": "aud_123",
      "audienceName": "Active trial users",
      "status": "sent",
      "totalRecipients": 12400,
      "sentCount": 12180,
      "failedCount": 0,
      "skippedCount": 220,
      "createdAt": "2026-04-08T12:34:56.789Z",
      "updatedAt": "2026-04-08T12:41:10.000Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
default:Bearer brew_your_api_key
required

Send your Brew API key as Authorization: Bearer brew_xxx.

Query Parameters

​
audienceRunId
string

Fetch a single audience run by id.

Required string length: 1 - 64
​
automationId
string

Filter runs to a single automation.

Required string length: 1 - 64
​
limit
integer

Max rows to return (1–200, default 50).

Required range: 1 <= x <= 200

Response

Audience runs (list mode), or { data: [row] } (detail).

​
data
object[]
required