Saltar al contenido principal
GET
/
crm
/
v3
/
lists
/
object-type-id
/
{objectTypeId}
/
name
/
{listName}
Recuperar lista por nombre
curl --request GET \
  --url https://api.hubapi.com/crm/v3/lists/object-type-id/{objectTypeId}/name/{listName} \
  --header 'Authorization: Bearer <token>'
{
  "list": {
    "createdAt": "2023-11-15T18:10:11.793Z",
    "createdById": "123",
    "filtersUpdatedAt": "2023-11-15T18:10:11.793Z",
    "listId": "1",
    "listVersion": 1,
    "name": "Manual List Example",
    "objectTypeId": "0-1",
    "processingStatus": "COMPLETE",
    "processingType": "MANUAL",
    "size": 330,
    "updatedAt": "2023-11-15T18:10:11.923Z",
    "updatedById": "123"
  }
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

​
Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

​
listName
string
requerido

El nombre de la lista que se recuperará. No distingue entre mayúsculas y minúsculas.

​
objectTypeId
string
requerido

El ID de los tipos de objetos almacenados por la lista que se recuperará. Por ejemplo, "0-1" para una lista "CONTACTO".

Parámetros de consulta

​
includeFilters
boolean
predeterminado:false

Un marcador que indica si la definición de la lista de objetos de la respuesta debe incluir o no una definición de ramificación de filtro. Por opción predeterminada, las definiciones de ramificaciones de filtro de las definiciones de la lista de objetos no se incluirán en la respuesta.

Respuesta

Successful response, for a request with includeFilters set to false.

The response for a list fetch request.

​
list
object
requerido

An object list definition.

Last modified on March 30, 2026