Contact Lists
List Contact Lists
List all contact lists in your account with optional pagination using the AutoSend API.
GET
/
contact-lists
curl --request GET \
--url 'https://api.autosend.com/v1/contact-lists?type=list' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"lists": [
{
"id": "GLOBAL_CONTACT_LIST",
"name": "All Contacts",
"description": "All contacts in the project",
"type": "list",
"contactCount": 1250
},
{
"id": "60d5ec49f1b2c72d9c8b4567",
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list",
"contactCount": 340,
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-02-20T14:45:00.000Z"
},
{
"id": "60d5ec49f1b2c72d9c8b9876",
"name": "Active Users",
"description": "Segment of users who opened an email in the last 30 days",
"type": "segment",
"contactCount": 890,
"filterCriteria": {
"logicalOperator": "AND",
"groups": [
{
"field": "lastActivity",
"fieldType": "date",
"operator": "after",
"value": "2026-02-17T00:00:00.000Z"
}
]
},
"createdAt": "2026-02-01T08:15:00.000Z",
"updatedAt": "2026-03-01T11:20:00.000Z"
}
]
}
}
curl --request GET \
--url 'https://api.autosend.com/v1/contact-lists?type=list' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"lists": [
{
"id": "GLOBAL_CONTACT_LIST",
"name": "All Contacts",
"description": "All contacts in the project",
"type": "list",
"contactCount": 1250
},
{
"id": "60d5ec49f1b2c72d9c8b4567",
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list",
"contactCount": 340,
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-02-20T14:45:00.000Z"
},
{
"id": "60d5ec49f1b2c72d9c8b9876",
"name": "Active Users",
"description": "Segment of users who opened an email in the last 30 days",
"type": "segment",
"contactCount": 890,
"filterCriteria": {
"logicalOperator": "AND",
"groups": [
{
"field": "lastActivity",
"fieldType": "date",
"operator": "after",
"value": "2026-02-17T00:00:00.000Z"
}
]
},
"createdAt": "2026-02-01T08:15:00.000Z",
"updatedAt": "2026-03-01T11:20:00.000Z"
}
]
}
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Query Parameters
Filter contact lists by type.Allowed values:
list, segmentExample: "list"Response
Contact lists retrieved successfullyIndicates if the request was successfulExample:
trueShow child attributes
Show child attributes
Array of contact list objects. The virtual “All Contacts” list is always prepended as the first item with ID
GLOBAL_CONTACT_LIST.Show child attributes
Show child attributes
Unique contact list identifier. The global list uses the special ID
GLOBAL_CONTACT_LIST.Example: "60d5ec49f1b2c72d9c8b4567"Name of the contact listExample:
"Newsletter Subscribers"Description of the contact listExample:
"Users who signed up for the weekly newsletter"Type:
list or segmentExample: "list"Number of contacts in the listExample:
340Filter criteria (for segments only)
Parent list ID (if sub-segment)
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 GET \
--url 'https://api.autosend.com/v1/contact-lists?type=list' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"lists": [
{
"id": "GLOBAL_CONTACT_LIST",
"name": "All Contacts",
"description": "All contacts in the project",
"type": "list",
"contactCount": 1250
},
{
"id": "60d5ec49f1b2c72d9c8b4567",
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list",
"contactCount": 340,
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-02-20T14:45:00.000Z"
},
{
"id": "60d5ec49f1b2c72d9c8b9876",
"name": "Active Users",
"description": "Segment of users who opened an email in the last 30 days",
"type": "segment",
"contactCount": 890,
"filterCriteria": {
"logicalOperator": "AND",
"groups": [
{
"field": "lastActivity",
"fieldType": "date",
"operator": "after",
"value": "2026-02-17T00:00:00.000Z"
}
]
},
"createdAt": "2026-02-01T08:15:00.000Z",
"updatedAt": "2026-03-01T11:20:00.000Z"
}
]
}
}