Skip to main content
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

​
Authorizations
string | header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Body

Search parameters for retrieving contacts within a list
​
contactListId
string
required
The ID of the contact list to search in.Example: "60d5ec49f1b2c72d9c8b4567"
​
page
integer
Page number for pagination (starts at 1).Minimum: 1Default: 1Example: 1
​
limit
integer
Number of results per page.Range: 1 - 100Default: 20Example: 20
​
email
string
Filter contacts by email address (partial match).Example: "jane"

​
Response

Contacts retrieved successfully
​
success
boolean
Indicates if the request was successfulExample: true
​
data
object