Skip to main content
GET
List audience segments
List segments with pagination. Requires the audience:read scope.

Authorizations

Authorization
string
header
required

API key for authentication

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
per_page
integer
default:20

Items per page (max 100)

Required range: 1 <= x <= 100
list_id
string<uuid>

Filter to segments restricted to a specific list (must belong to the team)

Response

Segments retrieved successfully.

message
string
required
Example:

"Segments retrieved successfully."

data
object
required