Skip to main content
GET
List audience contacts
Use this endpoint to retrieve a paginated list of contacts inside an audience.

Endpoint

GET /audience/contacts Authentication: Required (workspace auth)

Query Parameters

Response

Behavior

  • If the workspace has phone number masking enabled, mobile_no is returned masked.
  • Dynamic columns (one per input variable, e.g. name above) are built from the audience’s saved input variables plus any extra keys found on the contact rows themselves — mobile/phone alias columns are skipped since mobile_no already has its own column.
  • Results are ordered by contact ID descending.

Error Cases

Example cURL

Headers

token
string
required

API token for authentication

Query Parameters

audience_id
integer
required

Audience identifier

page
integer

Page number (default: 1)

limit
integer

Records per page (default: 10)

Partial mobile number search (LIKE). mobile_no is accepted as a fallback alias.

Response

Audience contacts retrieved successfully

datalist
object[]
pagination
object