List all contact lists in your account with optional pagination using the AutoSend API.
curl --request GET \
--url 'https://api.autosend.com/v1/contact-lists?type=list' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"contacts": [
{
"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": {
"contacts": [
{
"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"
}
]
}
}
<token>, where <token> is your auth token.list, segmentExample: "list"trueShow child attributes
GLOBAL_CONTACT_LIST.Show child attributes
GLOBAL_CONTACT_LIST.Example: "60d5ec49f1b2c72d9c8b4567""Newsletter Subscribers""Users who signed up for the weekly newsletter"list or segmentExample: "list"340"2026-01-15T10:30:00.000Z""2026-02-20T14:45:00.000Z"curl --request GET \
--url 'https://api.autosend.com/v1/contact-lists?type=list' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"contacts": [
{
"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"
}
]
}
}