Skip to main content
GET
Retrieve an audience

Authorizations

Authorization
string
header
required

A workspace API token. Create one in Settings → API. Send it as Authorization: Bearer sk_live_....

Path Parameters

audience_id
string
required

Unique identifier for an audience.

Pattern: ^aud_[0-9a-f]{32}$
Example:

"aud_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

Response

Successful Response

A named list of contacts a campaign can draw from.

created_at
string<date-time>
required
id
string
required

Unique identifier for an audience.

Pattern: ^aud_[0-9a-f]{32}$
Example:

"aud_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

name
string
required
status
string
required
updated_at
string<date-time>
required
object
string
default:audience
Allowed value: "audience"