Get All Lists

Retrieve all contact lists associated with your account.

GET /api/v1/{account_code}/lists/get-all/
Authorization Bearer {token}  — 56 characters

This endpoint returns the complete list of contact lists in your account, including details such as name, category, status, and creation date. No request body parameters are required.

Success Response

200 OK
JSON 
{
  "success": true,
  "data": [
    {
      "list_id": 123,
      "list_name": "February 2026 Clients",
      "active_contacts": 850
    },
    {
      "list_id": 98,
      "list_name": "January Newsletter",
      "active_contacts": 2100
    }
  ]
}

Response Fields

Field Type Description
successbooleanOperation result
dataarrayArray of lists. Empty ([]) if no lists exist
data[].list_idintegerUnique list ID
data[].list_namestringList name
data[].active_contactsintegerNumber of contacts in the list

Common Errors

403 Forbidden — Invalid token
JSON 
{
  "success": false,
  "message": "NO Token Found."
}