GET
/
contacts
/
v1
/
lists
/
dynamic
Get dynamic contact lists
curl --request GET \
  --url https://api.hubapi.com/contacts/v1/lists/dynamic
{
  "lists": [
    {
      "listId": 123,
      "name": "<string>",
      "dynamic": true,
      "listType": "STATIC",
      "portalId": 123,
      "createdAt": 123,
      "updatedAt": 123,
      "internalListId": 123,
      "deleteable": true,
      "metaData": {
        "processing": "<string>",
        "size": 123,
        "error": "<string>",
        "lastProcessingStateChangeAt": 123,
        "lastSizeChangeAt": 123
      },
      "filters": [
        [
          {}
        ]
      ]
    }
  ],
  "offset": 123,
  "has-more": true
}

Query Parameters

​
count
integer
default:20

An integer that represents the number of lists that you want returned to your call. Defaults to 20, with a maximum of 250.

Required range: x <= 250
​
offset
integer

An integer that represents where to start your list pull from. You can use this offset parameter to pull lists that weren't in your initial call.

Response

200 - application/json

Successful response with dynamic contact lists

The response is of type object.