Creating legacy public apps and project-based apps is temporarily unavailable for new HubSpot accounts.
Learn more in our Trust Center.
curl --request GET \
--url https://api.hubapi.com/contacts/v1/lists/batch{
"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": [
[
{}
]
]
}
]
}For a given account, return a set of contact lists that you specify with multiple listId parameters. This will return only the metadata on these lists and not all of the contacts in the list.
curl --request GET \
--url https://api.hubapi.com/contacts/v1/lists/batch{
"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": [
[
{}
]
]
}
]
}An integer that represents the list IDs that you want returned to your call. You can specify as many "listId" parameters as you wish to return multiple lists at once. Any list IDs that are invalid will be ignored.
Successful response with group of contact lists
Show child attributes
Was this page helpful?