Saltar al contenido principal
GET
/
contacts
/
v1
/
lists
/
{list_id}
Get a contact list by its unique ID
curl --request GET \
  --url https://api.hubapi.com/contacts/v1/lists/{list_id}
{
  "listId": 123,
  "name": "<string>",
  "dynamic": true,
  "portalId": 123,
  "createdAt": 123,
  "updatedAt": 123,
  "internalListId": 123,
  "deleteable": true,
  "metaData": {
    "processing": "<string>",
    "size": 123,
    "error": "<string>",
    "lastProcessingStateChangeAt": 123,
    "lastSizeChangeAt": 123
  },
  "filters": [
    [
      {}
    ]
  ]
}

Parámetros de ruta

list_id
integer
requerido

Unique identifier for the list that you're looking for.

Respuesta

200 - application/json

Successful response with contact list details

listId
integer
name
string
dynamic
boolean
listType
enum<string>
Opciones disponibles:
STATIC,
DYNAMIC
portalId
integer
createdAt
integer
updatedAt
integer
internalListId
integer
deleteable
boolean
metaData
object
filters
object[][]
Última modificación el 13 de abril de 2026