API Reference
Contacts
Custom Fields
Campaigns
Contact Lists
Contact Lists
Get Contact List
Retrieve the details of a specific contact list by its ID using the AutoSend API.
GET
/
contact-lists
/
{contactListId}
curl --request GET \
--url https://api.autosend.com/v1/contact-lists/60d5ec49f1b2c72d9c8b4567 \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"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"
}
}
curl --request GET \
--url https://api.autosend.com/v1/contact-lists/60d5ec49f1b2c72d9c8b4567 \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"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"
}
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Path Parameters
The unique identifier of the contact list. Use
GLOBAL_CONTACT_LIST to get the virtual “All Contacts” list.Example: "60d5ec49f1b2c72d9c8b4567"Response
Contact list retrieved successfullyIndicates if the request was successfulExample:
trueThe contact list object
Show child attributes
Show child attributes
Unique contact list identifierExample:
"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/60d5ec49f1b2c72d9c8b4567 \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"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"
}
}