Estimate an audience

How many contacts an audience reaches right now — send the exact audience you would send to POST /v1/messaging/broadcast/audience. It is resolved and validated the same way (same filter rules, same ownership checks, same 33040/33041 errors) and counted the same way a send counts it. Nothing is sent — so an audience matching nobody is count: 0, not the 33039 a send returns.

The count is live: contacts joining or leaving your groups change it. For a very large audience counting stops early and exact is false — read count as "more than".

Rate limit: 5 requests per minute — each estimate counts the whole audience.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
audience
object
required
Responses

401

Unauthorized. 33001.

429

Too Many Requests. 33002 rate limit exceeded.

500

Internal Server Error. 33000.

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json