v1

latestSwagger 2.0MIT2026-07-17233380637.0 KB

Contacts

Get a list's details

get/contacts/lists/{listId}

Path parameters

listIdinteger required

Id of the list

Query parameters

startDatestring

Mandatory if endDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id.Prefer to pass your timezone in date-time format for accurate result

endDatestring

Mandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id.Prefer to pass your timezone in date-time format for accurate result

Response

List informations

idinteger required

ID of the list

namestring required

Name of the list

totalBlacklistedinteger required

Number of blacklisted contacts in the list

totalSubscribersinteger required

Number of contacts in the list

uniqueSubscribersinteger required

Number of unique contacts in the list

folderIdinteger required

ID of the folder

createdAtstring required

Creation UTC date-time of the list (YYYY-MM-DDTHH:mm:ss.SSSZ)

dynamicListboolean

Status telling if the list is dynamic or not (true=dynamic, false=not dynamic)

Example response

{
  "id": 23,
  "name": "Magento Customers - EN",
  "totalBlacklisted": 13,
  "totalSubscribers": 1776,
  "uniqueSubscribers": 1789,
  "folderId": 2,
  "createdAt": "2017-03-13T17:05:09Z",
  "campaignStats": [
    {
      "campaignId": 143,
      "stats": {
        "listId": 2,
        "uniqueClicks": 2300,
        "clickers": 2665,
        "complaints": 1,
        "delivered": 19765,
        "sent": 19887,
        "softBounces": 100,
        "hardBounces": 87,
        "uniqueViews": 7779,
        "trackableViews": 5661,
        "trackableViewsRate": 23.45,
        "estimatedViews": 560,
        "unsubscriptions": 2,
        "viewed": 8999,
        "deferred": 30,
        "returnBounce": 5
      }
    }
  ]
}