---
title: "List all"
method: POST
path: "/crm/lists/2026-09/all"
tags: ["Basic"]
---

# List all

`POST /crm/lists/2026-09/all`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/lists/2026-09/all`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.segments.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.read`

Retrieve all lists in the CRM system. This endpoint allows you to fetch a comprehensive list of all available lists, which can be useful for managing and organizing your CRM data effectively.

## Request body

- ListAllRequest
  - `additionalProperties` string[], required: An array of strings representing additional properties to include in the list retrieval.
  - `after` string: A string used as a paging cursor token to retrieve the next set of results.
  - `count` integer: An integer specifying the number of results to retrieve.
  - `objectTypeId` string: A string representing the unique identifier for the object type of the lists.
  - `processingTypes` string[], required: An array of strings specifying the types of processing to apply to the request.

## Response `200`

successful operation

- ApiCollectionResponsePublicObjectListSearchResult
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A string token used as a cursor to retrieve the next page of results. It is returned as the `paging.next.after` JSON property in a paged response.
      - `link` string: A URL string that provides a direct link to the next page of results.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A string token used to identify the position in the list before the current page, enabling navigation to the previous page.
      - `link` string: A URL string that provides a direct link to the previous page of results.
  - `results` PublicObjectListSearchResult[], required: An array of PublicObjectListSearchResult objects representing the individual search results.
    - `additionalProperties` object, required: An object containing additional properties of the list, with each property represented as a string.
    - `createdAt` string, date-time: The date and time when the list was created, in ISO 8601 format.
    - `createdById` string: The unique identifier of the user who created the list, represented as a string.
    - `deletedAt` string, date-time: The date and time when the list was deleted, in ISO 8601 format.
    - `filtersUpdatedAt` string, date-time: The date and time when the list's filters were last updated, in ISO 8601 format.
    - `listId` string, required: The unique identifier for the list, represented as a string.
    - `listVersion` integer, required: An integer indicating the version of the list.
    - `name` string, required: The name of the list, represented as a string.
    - `objectTypeId` string, required: The unique identifier for the type of object associated with the list, represented as a string.
    - `processingStatus` string, required: A string representing the current processing status of the list.
    - `processingType` string, required: A string indicating the type of processing applied to the list.
    - `updatedAt` string, date-time: The date and time when the list was last updated, in ISO 8601 format.
    - `updatedById` string: The unique identifier of the user who last updated the list, represented as a string.
  - `total` integer: An integer representing the total number of results available in the search, formatted as a 64-bit integer.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `e1dd745172d1`: 2 info
  - the security scope `crm.segments.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-09) `6d0e6dc36ca0`: 2 info
  - the security scope `crm.segments.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.read` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/crm-lists/changes/crm/lists/2026-09/all/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-lists.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-lists/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-lists/revisions/e1dd745172d1?raw)