Skip to main content
GET
/
contact-lists
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"
      }
    ]
  }
}

Authorizations

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

Query Parameters

type
string
Filter contact lists by type.Allowed values: list, segmentExample: "list"

Response

Contact lists retrieved successfully
success
boolean
Indicates if the request was successfulExample: true
data
object