Authorization: Bearer <token>. Get it with the sign-in call (POST /api/customer-users/partner-login).search looks in the name and the description. Send an empty body {} to get the first 20 segments.contactsCount is filled. The other counters (maleCount, femaleCount, unspecifiedGenderCount, phoneNumbersCount, emailCount) are 0; read them with GET /api/v2/segments/{id}.data[0] holds items (the segments of this page), totalCount (all segments that match), pageNumber and pageSize.optedInContactsCount and notOptedInContactsCount are filled in this list as well.curl --location 'https://api.veloconnect.me/api/v2/segments/query' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"pageNumber": 1,
"pageSize": 20,
"sortBy": "createdAt",
"sortDescending": true
}'{
"data": [
{
"items": [
{
"id": 58,
"businessId": 1042,
"name": "Newsletter readers",
"description": null,
"sourceType": "Manual",
"isDynamic": false,
"filterDefinitionJson": null,
"createdAt": "2026-10-06T13:40:00Z",
"createdBy": 2087,
"modifiedAt": "2026-10-07T07:05:00Z",
"modifiedBy": 2087,
"contactsCount": 1312,
"maleCount": 0,
"femaleCount": 0,
"unspecifiedGenderCount": 0,
"phoneNumbersCount": 0,
"emailCount": 0
},
{
"id": 57,
"businessId": 1042,
"name": "Yerevan customers",
"description": "Customers who ordered in Yerevan in 2026",
"sourceType": "Manual",
"isDynamic": false,
"filterDefinitionJson": null,
"createdAt": "2026-10-01T08:15:00Z",
"createdBy": 2087,
"modifiedAt": null,
"modifiedBy": null,
"contactsCount": 248,
"maleCount": 0,
"femaleCount": 0,
"unspecifiedGenderCount": 0,
"phoneNumbersCount": 0,
"emailCount": 0
}
],
"totalCount": 2,
"pageSize": 20,
"pageNumber": 1
}
]
}