Authorization: Bearer <token>. Get it with the sign-in call (POST /api/customer-users/partner-login).{} returns the 20 newest contacts.search looks in the names, the company name, your externalReference and every detail value (phone number, e-mail address). It ignores upper and lower case.channel, gender, ageGroup, country, contactId, segmentId and excludeSegmentId narrow the list. A contact must pass every filter you send.sortBy accepts firstname, lastname, companyname, gender, age, createdat or modifiedat; any other text sorts by id. sortDescending is true by default.pageNumber starts at 1. pageSize is 1 to 1000, default 20.totalCount is the number of contacts that match, over all pages.curl --location 'https://api.veloconnect.me/api/v2/contacts/query' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"pageNumber": 1,
"pageSize": 20,
"search": "Petrosyan",
"channel": "Phone",
"sortBy": "lastname",
"sortDescending": false
}'{
"data": [
{
"items": [
{
"id": 1042,
"businessId": 57,
"firstName": "Anna",
"lastName": "Petrosyan",
"middleName": null,
"dateOfBirth": "1990-05-14T00:00:00Z",
"gender": "F",
"companyName": "Example LLC",
"jobTitle": "Marketing manager",
"notes": "Prefers messages in the morning",
"externalReference": "CRM-1042",
"createdAt": "2026-10-08T09:30:00Z",
"createdBy": 57,
"modifiedAt": null,
"modifiedBy": null,
"details": [
{
"id": 3310,
"businessContactId": 1042,
"type": "Phone",
"value": "+37491234567",
"normalizedValue": "+37491234567",
"label": "Mobile",
"isPrimary": true,
"isVerified": false,
"status": "Active",
"createdAt": "2026-10-08T09:30:00Z",
"createdBy": 57,
"modifiedAt": null,
"modifiedBy": null
},
{
"id": 3311,
"businessContactId": 1042,
"type": "Email",
"value": "anna@example.com",
"normalizedValue": "anna@example.com",
"label": "Work",
"isPrimary": true,
"isVerified": false,
"status": "Active",
"createdAt": "2026-10-08T09:30:00Z",
"createdBy": 57,
"modifiedAt": null,
"modifiedBy": null
}
]
}
],
"totalCount": 1,
"pageSize": 20,
"pageNumber": 1
}
]
}