Sign in

v1

latestSwagger 2.0Private2026-08-04128286690.5 KB
Contact Lists

GET a List

Use this method to get details about a specific contact list (list_id).

get/contact_lists/{list_id}

Path parameters

list_idstring uuid required

The system generated ID that uniquely identifies a contact list.

Query parameters

include_membership_count'all' | 'active'

Returns the total number of contacts per list that meet your selection criteria. Set the include_membership_count to active, to count only active contacts, or all to include all contacts in the count.

Response

Request successful

list_idstring uuid required

Unique ID for the contact list

namestring required

The name given to the contact list

descriptionstring

Text describing the list.

favoriteboolean

Identifies whether or not the account has favorited the contact list.

created_atstring date-time

System generated date and time that the resource was created, in ISO-8601 format.

updated_atstring date-time

Date and time that the list was last updated, in ISO-8601 format. System generated.

deleted_atstring date-time

If the list was deleted, this property shows the date and time it was deleted, in ISO-8601 format. System generated.

membership_countinteger

The total number of contacts that are members in a list. Does not apply to segment type lists.

Example response

{
  "list_id": "06526938-56dd-11e9-932a-fa163ea075fa",
  "name": "Multiple purchases",
  "description": "List of repeat customers.",
  "created_at": "2016-01-23T13:48:44.108Z",
  "updated_at": "2016-03-03T10:56:29-05:00",
  "deleted_at": "2016-03-03T10:56:29-05:00",
  "membership_count": 327
}