Get Audiences

  • Published on Mar 17, 2026
  • 1 minute(s) read
  • EM
 Prev Next
Get
/audiences

This API returns a list of all existing audiences for the authenticated account.

No Path or Body params are required.

Security
HTTP
Type bearer

API key is needed to authorize requests. You can get your API key via the management console.
A Bearer Token is needed to be set in the Authorization header of every API call.
For additional support you can contact us.

Responses
200

OK

object
status
string
Example200
description
string
ExampleAudiences retrieved
response_time
string
Example2026-02-11T12:00:00.000Z
data
Array
OneOf
object
object
id
string

Unique identifier for the audience

Example31234
name
string

Audience name

ExampleNE_USA-above50
created_time
string (ISO 8601)

Timestamp of audience creation

Example2025-10-01T09:10:00Z
user_count
integer

Number of users currently in the static audience

Example1542
type
string

Audience type: 'Static' or 'Dynamic'

ExampleStatic
object
object
id
string

Unique identifier for the audience

Example45412
name
string

Audience name

ExampleVIP
created_time
string (ISO 8601)

Timestamp of audience creation

Example2025-11-01T08:30:00Z
type
string

Audience type: 'Static' or 'Dynamic'

ExampleDynamic
400

Bad Request - The request could not be understood by the server.

object
status
integer
Example400
description
string
ExampleBad Request
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
401

Unauthorized - Invalid or missing Bearer token

object
status
integer
Example401
description
string
ExampleUnauthorized
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
404

Not Found - The requested resource was not found

object
status
integer
Example404
description
string
ExampleNot Found
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
429

Too Many Requests - Too many requests have been made in a short period of time (Throttling)

object
status
integer
Example429
description
string
ExampleToo Many Requests – Rate limit exceeded
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
500

Internal Server Error

object
status
integer
Example500
description
string
ExampleServer Error
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z