Saltar al contenido principal
POST
/
crm
/
lists
/
2026-03
/
search
cURL
curl --request POST \
  --url https://api.hubapi.com/crm/lists/2026-03/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "additionalProperties": [
    "<string>"
  ],
  "listIds": [
    "<string>"
  ],
  "offset": 123,
  "processingTypes": [
    "<string>"
  ],
  "count": 123,
  "objectTypeId": "<string>",
  "query": "<string>",
  "sort": "<string>"
}
'
{
  "hasMore": true,
  "lists": [
    {
      "additionalProperties": {},
      "listId": "<string>",
      "listVersion": 123,
      "name": "<string>",
      "objectTypeId": "<string>",
      "processingStatus": "<string>",
      "processingType": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "createdById": "<string>",
      "deletedAt": "2023-11-07T05:31:56Z",
      "filtersUpdatedAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "updatedById": "<string>"
    }
  ],
  "offset": 123,
  "total": 123
}

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.

Supported products

Autorizaciones

Authorization
string
header
requerido

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

Cuerpo

application/json
additionalProperties
string[]
requerido

Los nombres de las propiedades de lista adicionales que se incluirán en la respuesta. Las propiedades que no existen o que están vacías para una lista en particular no se incluyen en la respuesta.

Por opción predeterminada, todas las solicitudes recuperarán las siguientes propiedades para cada lista: hs_list_size, hs_last_record_added_at, hs_last_record_removed_at, hs_folder_name y hs_list_reference_count.

listIds
string[]
requerido

Identificadores de listas ILS que se incluirán en los resultados de búsqueda. Si no se especifica, se incluirán todas las listas que coincidan con otros criterios

offset
integer<int32>
requerido

Valor utilizado para paginar las listas. El valor de "desplazamiento" proporcionado en la respuesta se puede usar en la siguiente solicitud para recuperar la siguiente página de resultados. Por opción predeterminada, se establece en "0" si no se proporciona ningún desplazamiento.

processingTypes
string[]
requerido

Tipos de procesamiento de listas que se incluirán en los resultados de búsqueda. Si no se especifica, se incluirán todas las listas con todos los tipos de procesamiento.

count
integer<int32>

El número de listas que se incluirán en la respuesta. Por opción predeterminada, se establece en "20" si no se proporciona ningún valor. El "conteo" máximo es "500".

objectTypeId
string
query
string

La "consulta" que se utilizará para buscar listas por nombre de lista. Si no se proporciona ninguna "consulta", los resultados incluirán todas las listas.

sort
string

Ordenar campo y orden

Respuesta

successful operation

hasMore
boolean
requerido

Si hay o no hay más resultados para paginar.

lists
object[]
requerido

Las listas que coincidieron con los criterios de búsqueda.

offset
integer<int32>
requerido

Valor que se pasará en una futura solicitud para paginar los resultados de la búsqueda de listas.

total
integer<int32>
requerido

El número total de listas que coinciden con los criterios de búsqueda.

Last modified on April 14, 2026