Skip to main content
GET
Get Campaign Audience
Resolve a campaign’s stored targeting into named lists and segments plus a recipient count computed at read time. Use this to verify a scheduled campaign’s audience before it sends. Unlike targetLists on Get Campaign, which contains raw IDs, this endpoint returns resolved names, flags references to deleted records, and reports whether targeting was ever set.
When audience.isUnset is true, the campaign has no targeting. Scheduling it sends to every active subscriber, and recipientCount reflects that fallback.

Request

string
required
Campaign ID.

Response fields

string
One of unset, all, lists, segment, filtered, or rules.
string
Plain-language description of who the campaign reaches.
boolean
True when targeting has never been set.
array
Resolved lists. Each entry has id, name, and missing - missing is true when the referenced list no longer exists.
array
Resolved segments, in the same shape as lists.
array
Include rules for rules targeting, with lists and segments resolved.
array
Exclude rules for rules targeting, with lists and segments resolved.
number
Subscribers matching the effective targeting right now.

Responses