List contacts segments with pagination

Returns a paginated list of all contacts segments defined in your app.
Segments are ordered by ID descending (most recently created first).

Pagination

This endpoint uses cursor-based pagination:

  • per_page: Number of segments per page (default: 20, max: 100)
  • cursor: The segment_id from the last item of the previous page

Flow:

  1. First request: GET /segments/contacts?per_page=20
  2. Read cursor from response
  3. Next page: GET /segments/contacts?per_page=20&cursor=<cursor>
  4. Continue until cursor is null
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
1 to 100
Defaults to 20

Number of segments per page (default: 20, max: 100)

integer

Cursor from the previous page's response. Omit for the first page.

Responses

401

Authentication credentials are missing or invalid

422

Validation error in query parameters

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