API Reference
Contacts
Custom Fields
Campaigns
Contact Lists
Contact Lists
Get Contacts in List
Search and retrieve contacts within a specific contact list using the AutoSend API.
POST
/
contact-lists
/
contacts
/
search
curl --request POST \
--url https://api.autosend.com/v1/contact-lists/contacts/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"contactListId": "60d5ec49f1b2c72d9c8b4567",
"page": 1,
"limit": 20,
"email": "jane"
}'
{
"success": true,
"data": {
"contacts": [
{
"id": "60d5ec49f1b2c72d9c8b1111",
"email": "[email protected]",
"firstName": "Jane",
"lastName": "Smith",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-02-20T14:45:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"pages": 1
}
}
}
curl --request POST \
--url https://api.autosend.com/v1/contact-lists/contacts/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"contactListId": "60d5ec49f1b2c72d9c8b4567",
"page": 1,
"limit": 20,
"email": "jane"
}'
{
"success": true,
"data": {
"contacts": [
{
"id": "60d5ec49f1b2c72d9c8b1111",
"email": "[email protected]",
"firstName": "Jane",
"lastName": "Smith",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-02-20T14:45:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"pages": 1
}
}
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Body
Search parameters for retrieving contacts within a listThe ID of the contact list to search in.Example:
"60d5ec49f1b2c72d9c8b4567"Page number for pagination (starts at 1).Minimum:
1Default: 1Example: 1Number of results per page.Range:
1 - 100Default: 20Example: 20Filter contacts by email address (partial match).Example:
"jane"Response
Contacts retrieved successfullyIndicates if the request was successfulExample:
trueShow child attributes
Show child attributes
Array of contact objects
Show child attributes
Show child attributes
Unique contact identifierExample:
"60d5ec49f1b2c72d9c8b1111"Contact email addressExample:
"[email protected]"Contact first nameExample:
"Jane"Contact last nameExample:
"Smith"ISO 8601 timestamp of creationExample:
"2026-01-15T10:30:00.000Z"ISO 8601 timestamp of last updateExample:
"2026-02-20T14:45:00.000Z"⌘I
curl --request POST \
--url https://api.autosend.com/v1/contact-lists/contacts/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"contactListId": "60d5ec49f1b2c72d9c8b4567",
"page": 1,
"limit": 20,
"email": "jane"
}'
{
"success": true,
"data": {
"contacts": [
{
"id": "60d5ec49f1b2c72d9c8b1111",
"email": "[email protected]",
"firstName": "Jane",
"lastName": "Smith",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-02-20T14:45:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"pages": 1
}
}
}