Contacts
List Segments
Paginate the acting user's contact segments.
GET
/io/contacts/segmentsReturns a paginated list of segments.
Query parameters
pageintegerqueryPage number (default
1).limitintegerqueryResults per page, 1–100 (default
20).searchstringqueryPartial match on segment name.
{
"data": [
{
"id": "seg_abc",
"name": "High-value subscribers",
"segment_type": "dynamic",
"contact_count": 312,
"last_calculated_at": "2026-06-10T09:00:00Z"
}
],
"pagination": { "total": 8, "page": 1, "limit": 20, "totalPages": 1 }
}