Sign in

v1

latestSwagger 2.0MIT2026-07-17233380637.0 KB
Contacts

Get contacts in a list

get/contacts/lists/{listId}/contacts

Path parameters

listIdinteger required

Id of the list

Query parameters

modifiedSincestring

Filter (urlencoded) the contacts modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.

limitinteger

Number of documents per page

offsetinteger

Index of the first document of the page

sort'asc' | 'desc'

Sort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

Response

Contact informations

countinteger required

Number of contacts

Example response

{
  "contacts": [
    {
      "email": "john.smith@example.com",
      "id": 32,
      "smsBlacklisted": true,
      "createdAt": "2017-05-12T12:30:00Z",
      "modifiedAt": "2017-05-12T12:30:00Z",
      "attributes": {
        "name": "Joe",
        "email": "joe@example.com"
      }
    }
  ],
  "count": 17655
}