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

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

​
Path Parameters

​
contactListId
string
required
The unique identifier of the contact list. Use GLOBAL_CONTACT_LIST to get the virtual “All Contacts” list.Example: "60d5ec49f1b2c72d9c8b4567"

​
Response

Contact list retrieved successfully
​
success
boolean
Indicates if the request was successfulExample: true
​
data
object
The contact list object