Saltar al contenido principal
GET
/
contacts
/
v1
/
lists
/
batch
Get a group of contact lists
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": [
        [
          {}
        ]
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt

Use this file to discover all available pages before exploring further.

Parámetros de consulta

listId
integer[]
requerido

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.

Respuesta

200 - application/json

Successful response with group of contact lists

lists
object[]
Last modified on April 13, 2026