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
}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
}Supported products
Required Scopes
The access token received from the authorization server in the OAuth 2.0 flow.
Os nomes das propriedades de qualquer propriedade de lista adicional a ser incluída na resposta. Propriedades que não existem ou que estão vazias para uma lista específica não são incluídas na resposta.
Por padrão, todas as solicitações buscarão as seguintes propriedades para cada lista: "hs_list_size", "hs_last_record_added_at", "hs_last_record_removed_at", "hs_folder_name" e "hs_list_reference_count".
IDs de lista ILS a serem incluídos nos resultados da pesquisa. Se não especificado, todas as listas que corresponderem a outros critérios serão incluídas
Valor usado para paginar listas. O "offset" fornecido na resposta pode ser usado na próxima solicitação para buscar a próxima página de resultados. O padrão é "0" se nenhum ajuste for fornecido.
Liste os tipos de processamento a serem incluídos nos resultados da pesquisa. Se não for especificado, todas as listas com todos os tipos de processamento serão incluídas.
O número de listas a serem incluídas na resposta. O padrão é "20" se nenhum valor for fornecido. O valor máximo de "count" é "500".
A "query" que será usada para procurar listas pelo nome da lista. Se nenhuma "query" for fornecida, os resultados incluirão todas as listas.
Classificar campo e ordem
successful operation
Se há ou não mais resultados para navegar.
As listas que corresponderam aos critérios de pesquisa.
Show child attributes
Valor a ser transmitido em uma solicitação futura para paginar os resultados da pesquisa de lista.
O número total de listas que correspondem aos critérios de pesquisa.