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

# List

`GET /crm/lists/2026-09`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/lists/2026-09`
- 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 a list of CRM lists in your HubSpot account. This endpoint allows you to filter the lists by their IDs and optionally include filters applied to the lists. It is useful for managing and organizing your CRM data by accessing specific lists.

## Query parameters

- `includeFilters` boolean
- `listIds` string[]

## Response `200`

successful operation

- ListsByIdResponse
  - `lists` PublicObjectList[], required: An array of PublicObjectList objects, each representing a list retrieved by its ID. This property is required.
    - `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.
    - `filterBranch` union: An object representing the filter branch applied to the list, which can be one of several types of filter branches.
      - PublicOrFilterBranch
        - `filterBranchOperator` string, required: A string representing the operator used to combine the filters within the branch.
        - `filterBranchType` 'OR', required: A string indicating the type of filter branch, which is 'OR' for this component.
        - `filterBranches` union[], required: An array of nested filter branches, allowing for the combination of multiple logical conditions within the 'OR' branch.
          - union
            - PublicOrFilterBranch (recursive)
            - PublicAndFilterBranch
              - …
            - PublicNotAllFilterBranch
              - …
            - PublicNotAnyFilterBranch
              - …
            - PublicRestrictedFilterBranch
              - …
            - PublicUnifiedEventsFilterBranch
              - …
            - PublicAssociationFilterBranch
              - …
        - `filters` union[], required: An array of individual filters that are part of the 'OR' branch. Each filter represents a specific condition that can be evaluated.
          - union
            - PublicPropertyFilter
              - …
            - PublicAssociationInListFilter
              - …
            - PublicPageViewAnalyticsFilter
              - …
            - PublicCtaAnalyticsFilter
              - …
            - PublicEventAnalyticsFilter
              - …
            - PublicFormSubmissionFilter
              - …
            - PublicFormSubmissionOnPageFilter
              - …
            - PublicIntegrationEventFilter
              - …
            - PublicEmailSubscriptionFilter
              - …
            - PublicCommunicationSubscriptionFilter
              - …
            - PublicSurveyMonkeyFilter
              - …
            - PublicSurveyMonkeyValueFilter
              - …
            - PublicWebinarFilter
              - …
            - PublicEmailEventFilter
              - …
            - PublicPrivacyAnalyticsFilter
              - …
            - PublicAdsSearchFilter
              - …
            - PublicAdsTimeFilter
              - …
            - PublicInListFilter
              - …
            - PublicUnifiedEventsFilter
              - …
            - PublicConstantFilter
              - …
      - PublicAndFilterBranch
        - `filterBranchOperator` string, required: A string representing the operator used within this filter branch.
        - `filterBranchType` 'AND', required: A string indicating the type of filter branch. Defaults to 'AND'.
        - `filterBranches` union[], required: An array of nested filter branches. Each item can be a branch of various types, such as 'OR', 'AND', 'NOT_ALL', etc.
          - union
            - PublicOrFilterBranch
              - …
            - PublicAndFilterBranch (recursive)
            - PublicNotAllFilterBranch
              - …
            - PublicNotAnyFilterBranch
              - …
            - PublicRestrictedFilterBranch
              - …
            - PublicUnifiedEventsFilterBranch
              - …
            - PublicAssociationFilterBranch
              - …
        - `filters` union[], required: An array of filters that apply to this branch. Each filter can be of various types, such as property filters, event filters, or subscription filters.
          - union
            - PublicPropertyFilter
              - …
            - PublicAssociationInListFilter
              - …
            - PublicPageViewAnalyticsFilter
              - …
            - PublicCtaAnalyticsFilter
              - …
            - PublicEventAnalyticsFilter
              - …
            - PublicFormSubmissionFilter
              - …
            - PublicFormSubmissionOnPageFilter
              - …
            - PublicIntegrationEventFilter
              - …
            - PublicEmailSubscriptionFilter
              - …
            - PublicCommunicationSubscriptionFilter
              - …
            - PublicSurveyMonkeyFilter
              - …
            - PublicSurveyMonkeyValueFilter
              - …
            - PublicWebinarFilter
              - …
            - PublicEmailEventFilter
              - …
            - PublicPrivacyAnalyticsFilter
              - …
            - PublicAdsSearchFilter
              - …
            - PublicAdsTimeFilter
              - …
            - PublicInListFilter
              - …
            - PublicUnifiedEventsFilter
              - …
            - PublicConstantFilter
              - …
      - PublicNotAllFilterBranch
        - `filterBranchOperator` string, required: A string representing the operator used within the filter branch.
        - `filterBranchType` 'NOT_ALL', required: A string that specifies the type of filter branch. The default value is 'NOT_ALL'.
        - `filterBranches` union[], required: An array of filter branches that can include various types such as PublicOrFilterBranch, PublicAndFilterBranch, and others, allowing for nested filtering logic.
          - union
            - PublicOrFilterBranch
              - …
            - PublicAndFilterBranch
              - …
            - PublicNotAllFilterBranch (recursive)
            - PublicNotAnyFilterBranch
              - …
            - PublicRestrictedFilterBranch
              - …
            - PublicUnifiedEventsFilterBranch
              - …
            - PublicAssociationFilterBranch
              - …
        - `filters` union[], required: An array of filters that can include various types such as PublicPropertyFilter, PublicAssociationInListFilter, and others, used to apply specific conditions to the data.
          - union
            - PublicPropertyFilter
              - …
            - PublicAssociationInListFilter
              - …
            - PublicPageViewAnalyticsFilter
              - …
            - PublicCtaAnalyticsFilter
              - …
            - PublicEventAnalyticsFilter
              - …
            - PublicFormSubmissionFilter
              - …
            - PublicFormSubmissionOnPageFilter
              - …
            - PublicIntegrationEventFilter
              - …
            - PublicEmailSubscriptionFilter
              - …
            - PublicCommunicationSubscriptionFilter
              - …
            - PublicSurveyMonkeyFilter
              - …
            - PublicSurveyMonkeyValueFilter
              - …
            - PublicWebinarFilter
              - …
            - PublicEmailEventFilter
              - …
            - PublicPrivacyAnalyticsFilter
              - …
            - PublicAdsSearchFilter
              - …
            - PublicAdsTimeFilter
              - …
            - PublicInListFilter
              - …
            - PublicUnifiedEventsFilter
              - …
            - PublicConstantFilter
              - …
      - PublicNotAnyFilterBranch
        - `filterBranchOperator` string, required: A string representing the operator used in the filter branch.
        - `filterBranchType` 'NOT_ANY', required: A string that specifies the type of filter branch. Default value is 'NOT_ANY'.
        - `filterBranches` union[], required: An array of filter branches that can include various types such as 'PublicOrFilterBranch', 'PublicAndFilterBranch', 'PublicNotAllFilterBranch', 'PublicNotAnyFilterBranch', 'PublicRestrictedFilterBranch', 'PublicUnifiedEventsFilterBranch', and 'PublicAssociationFilterBranch'.
          - union
            - PublicOrFilterBranch
              - …
            - PublicAndFilterBranch
              - …
            - PublicNotAllFilterBranch
              - …
            - PublicNotAnyFilterBranch (recursive)
            - PublicRestrictedFilterBranch
              - …
            - PublicUnifiedEventsFilterBranch
              - …
            - PublicAssociationFilterBranch
              - …
        - `filters` union[], required: An array of filters that can include types like 'PublicPropertyFilter', 'PublicAssociationInListFilter', 'PublicPageViewAnalyticsFilter', 'PublicCtaAnalyticsFilter', 'PublicEventAnalyticsFilter', 'PublicFormSubmissionFilter', 'PublicFormSubmissionOnPageFilter', 'PublicIntegrationEventFilter', 'PublicEmailSubscriptionFilter', 'PublicCommunicationSubscriptionFilter', 'PublicSurveyMonkeyFilter', 'PublicSurveyMonkeyValueFilter', 'PublicWebinarFilter', 'PublicEmailEventFilter', 'PublicPrivacyAnalyticsFilter', 'PublicAdsSearchFilter', 'PublicAdsTimeFilter', 'PublicInListFilter', 'PublicUnifiedEventsFilter', and 'PublicConstantFilter'.
          - union
            - PublicPropertyFilter
              - …
            - PublicAssociationInListFilter
              - …
            - PublicPageViewAnalyticsFilter
              - …
            - PublicCtaAnalyticsFilter
              - …
            - PublicEventAnalyticsFilter
              - …
            - PublicFormSubmissionFilter
              - …
            - PublicFormSubmissionOnPageFilter
              - …
            - PublicIntegrationEventFilter
              - …
            - PublicEmailSubscriptionFilter
              - …
            - PublicCommunicationSubscriptionFilter
              - …
            - PublicSurveyMonkeyFilter
              - …
            - PublicSurveyMonkeyValueFilter
              - …
            - PublicWebinarFilter
              - …
            - PublicEmailEventFilter
              - …
            - PublicPrivacyAnalyticsFilter
              - …
            - PublicAdsSearchFilter
              - …
            - PublicAdsTimeFilter
              - …
            - PublicInListFilter
              - …
            - PublicUnifiedEventsFilter
              - …
            - PublicConstantFilter
              - …
      - PublicRestrictedFilterBranch
        - `filterBranchOperator` string, required: A string representing the operator used within the filter branch.
        - `filterBranchType` 'RESTRICTED', required: A string indicating the type of filter branch. The default value is 'RESTRICTED'.
        - `filterBranches` union[], required: An array of nested filter branches, which can include various types such as 'PublicOrFilterBranch', 'PublicAndFilterBranch', and others.
          - union
            - PublicOrFilterBranch
              - …
            - PublicAndFilterBranch
              - …
            - PublicNotAllFilterBranch
              - …
            - PublicNotAnyFilterBranch
              - …
            - PublicRestrictedFilterBranch (recursive)
            - PublicUnifiedEventsFilterBranch
              - …
            - PublicAssociationFilterBranch
              - …
        - `filters` union[], required: An array of filters applied within the branch, which can include different filter types like 'PublicPropertyFilter', 'PublicAssociationInListFilter', and more.
          - union
            - PublicPropertyFilter
              - …
            - PublicAssociationInListFilter
              - …
            - PublicPageViewAnalyticsFilter
              - …
            - PublicCtaAnalyticsFilter
              - …
            - PublicEventAnalyticsFilter
              - …
            - PublicFormSubmissionFilter
              - …
            - PublicFormSubmissionOnPageFilter
              - …
            - PublicIntegrationEventFilter
              - …
            - PublicEmailSubscriptionFilter
              - …
            - PublicCommunicationSubscriptionFilter
              - …
            - PublicSurveyMonkeyFilter
              - …
            - PublicSurveyMonkeyValueFilter
              - …
            - PublicWebinarFilter
              - …
            - PublicEmailEventFilter
              - …
            - PublicPrivacyAnalyticsFilter
              - …
            - PublicAdsSearchFilter
              - …
            - PublicAdsTimeFilter
              - …
            - PublicInListFilter
              - …
            - PublicUnifiedEventsFilter
              - …
            - PublicConstantFilter
              - …
      - PublicUnifiedEventsFilterBranch
        - `coalescingRefineBy` union: An optional refinement criterion that can be applied to coalesce event data. It can be one of several predefined refinement types.
          - PublicNumOccurrencesRefineBy
            - `maxOccurrences` integer: An integer specifying the maximum number of occurrences allowed.
            - `minOccurrences` integer: An integer specifying the minimum number of occurrences required.
            - `type` 'NUM_OCCURRENCES', required: A string indicating the type of refinement, which is 'NUM_OCCURRENCES' by default.
          - PublicSetOccurrencesRefineBy
            - `setType` string, required: A string specifying the set type used for the refinement.
            - `type` 'SET_OCCURRENCES', required: A string indicating the type of refinement, which is 'SET_OCCURRENCES'.
          - PublicRelativeComparativeTimestampRefineBy
            - `comparison` string, required: A string that defines the comparison operation to be used in the refinement.
            - `timeOffset` PublicTimeOffset, required
              - …
            - `type` 'RELATIVE_COMPARATIVE', required: A string that specifies the type of refinement, with the default value 'RELATIVE_COMPARATIVE'.
          - PublicRelativeRangedTimestampRefineBy
            - `lowerBoundOffset` PublicTimeOffset, required
              - …
            - `rangeType` string, required: A string that specifies the type of range being applied.
            - `type` 'RELATIVE_RANGED', required: A string indicating the type of refinement, with a default value of 'RELATIVE_RANGED'.
            - `upperBoundOffset` PublicTimeOffset, required
              - …
          - PublicAbsoluteComparativeTimestampRefineBy
            - `comparison` string, required: A string representing the comparison operation to be performed with the timestamp.
            - `timestamp` integer, required: An integer representing the specific timestamp to be used in the comparison, typically expressed as a Unix timestamp in milliseconds.
            - `type` 'ABSOLUTE_COMPARATIVE', required: A string representing the type of refinement, which is 'ABSOLUTE_COMPARATIVE' by default.
          - PublicAbsoluteRangedTimestampRefineBy
            - `lowerTimestamp` integer, required: An integer representing the lower bound of the timestamp range, in Unix time format (milliseconds).
            - `rangeType` string, required: A string that specifies the type of range being used in the filter.
            - `type` 'ABSOLUTE_RANGED', required: A string that indicates the type of refine by operation, which is 'ABSOLUTE_RANGED'.
            - `upperTimestamp` integer, required: An integer representing the upper bound of the timestamp range, in Unix time format (milliseconds).
          - PublicAllHistoryRefineBy
            - `type` 'ALL_HISTORY', required: A string that specifies the type of refinement, with a default value of 'ALL_HISTORY'.
          - PublicTimePointOperation
            - `endpointBehavior` string: A string describing the behavior of the endpoint in the context of the time point operation.
            - `includeObjectsWithNoValueSet` boolean, required: A boolean indicating whether to include objects that have no value set for the time point.
            - `operationType` 'TIME_POINT', required: A string indicating the type of operation, which is 'TIME_POINT' by default.
            - `operator` string, required: A string representing the operator used in the time point operation.
            - `propertyParser` string: A string representing the parser used for the property in the time point operation.
            - `timePoint` union, required: An object representing the specific time point used in the operation. It can be one of several types, such as a date point, indexed time point, or property-referenced time.
              - …
            - `type` string, required: A string indicating the specific type of the time point operation.
          - PublicRangedTimeOperation
            - `includeObjectsWithNoValueSet` boolean, required: A boolean indicating whether objects with no value set should be included in the operation.
            - `lowerBoundEndpointBehavior` string: A string specifying the behavior of the lower bound endpoint in the time range.
            - `lowerBoundTimePoint` union, required: An object representing the lower bound time point of the range, which can be a date point, indexed time point, or property-referenced time.
              - …
            - `operationType` string, required: A string indicating the operation type, which is related to time range operations.
            - `operator` string, required: A string representing the operator used in the time range operation.
            - `propertyParser` string: A string that defines the property parser used in the operation.
            - `type` 'TIME_RANGED', required: A string indicating the type of operation, which is 'TIME_RANGED'.
            - `upperBoundEndpointBehavior` string: A string specifying the behavior of the upper bound endpoint in the time range.
            - `upperBoundTimePoint` union, required: An object representing the upper bound time point of the range, which can be a date point, indexed time point, or property-referenced time.
              - …
        - `eventTypeId` string, required: A string that specifies the ID of the event type being filtered.
        - `filterBranchOperator` string, required: A string that specifies the logical operator used to combine the filters and filter branches within this branch.
        - `filterBranchType` 'UNIFIED_EVENTS', required: A string indicating the type of filter branch. Default value is 'UNIFIED_EVENTS'.
        - `filterBranches` union[], required: An array of nested filter branches, allowing for complex filter logic. Each item can be one of several filter branch types.
          - union
            - PublicOrFilterBranch
              - …
            - PublicAndFilterBranch
              - …
            - PublicNotAllFilterBranch
              - …
            - PublicNotAnyFilterBranch
              - …
            - PublicRestrictedFilterBranch
              - …
            - PublicUnifiedEventsFilterBranch (recursive)
            - PublicAssociationFilterBranch
              - …
        - `filters` union[], required: An array of filters applied to the events. Each filter can be one of several predefined filter types.
          - union
            - PublicPropertyFilter
              - …
            - PublicAssociationInListFilter
              - …
            - PublicPageViewAnalyticsFilter
              - …
            - PublicCtaAnalyticsFilter
              - …
            - PublicEventAnalyticsFilter
              - …
            - PublicFormSubmissionFilter
              - …
            - PublicFormSubmissionOnPageFilter
              - …
            - PublicIntegrationEventFilter
              - …
            - PublicEmailSubscriptionFilter
              - …
            - PublicCommunicationSubscriptionFilter
              - …
            - PublicSurveyMonkeyFilter
              - …
            - PublicSurveyMonkeyValueFilter
              - …
            - PublicWebinarFilter
              - …
            - PublicEmailEventFilter
              - …
            - PublicPrivacyAnalyticsFilter
              - …
            - PublicAdsSearchFilter
              - …
            - PublicAdsTimeFilter
              - …
            - PublicInListFilter
              - …
            - PublicUnifiedEventsFilter
              - …
            - PublicConstantFilter
              - …
        - `operator` 'HAS_COMPLETED' | 'HAS_NOT_COMPLETED', required: A string representing the operation to be performed on the events. Valid values are 'HAS_COMPLETED' and 'HAS_NOT_COMPLETED'.
        - `pruningRefineBy` union: An optional refinement criterion used to prune event data. It can be one of several predefined refinement types.
          - PublicNumOccurrencesRefineBy
            - `maxOccurrences` integer: An integer specifying the maximum number of occurrences allowed.
            - `minOccurrences` integer: An integer specifying the minimum number of occurrences required.
            - `type` 'NUM_OCCURRENCES', required: A string indicating the type of refinement, which is 'NUM_OCCURRENCES' by default.
          - PublicSetOccurrencesRefineBy
            - `setType` string, required: A string specifying the set type used for the refinement.
            - `type` 'SET_OCCURRENCES', required: A string indicating the type of refinement, which is 'SET_OCCURRENCES'.
          - PublicRelativeComparativeTimestampRefineBy
            - `comparison` string, required: A string that defines the comparison operation to be used in the refinement.
            - `timeOffset` PublicTimeOffset, required
              - …
            - `type` 'RELATIVE_COMPARATIVE', required: A string that specifies the type of refinement, with the default value 'RELATIVE_COMPARATIVE'.
          - PublicRelativeRangedTimestampRefineBy
            - `lowerBoundOffset` PublicTimeOffset, required
              - …
            - `rangeType` string, required: A string that specifies the type of range being applied.
            - `type` 'RELATIVE_RANGED', required: A string indicating the type of refinement, with a default value of 'RELATIVE_RANGED'.
            - `upperBoundOffset` PublicTimeOffset, required
              - …
          - PublicAbsoluteComparativeTimestampRefineBy
            - `comparison` string, required: A string representing the comparison operation to be performed with the timestamp.
            - `timestamp` integer, required: An integer representing the specific timestamp to be used in the comparison, typically expressed as a Unix timestamp in milliseconds.
            - `type` 'ABSOLUTE_COMPARATIVE', required: A string representing the type of refinement, which is 'ABSOLUTE_COMPARATIVE' by default.
          - PublicAbsoluteRangedTimestampRefineBy
            - `lowerTimestamp` integer, required: An integer representing the lower bound of the timestamp range, in Unix time format (milliseconds).
            - `rangeType` string, required: A string that specifies the type of range being used in the filter.
            - `type` 'ABSOLUTE_RANGED', required: A string that indicates the type of refine by operation, which is 'ABSOLUTE_RANGED'.
            - `upperTimestamp` integer, required: An integer representing the upper bound of the timestamp range, in Unix time format (milliseconds).
          - PublicAllHistoryRefineBy
            - `type` 'ALL_HISTORY', required: A string that specifies the type of refinement, with a default value of 'ALL_HISTORY'.
          - PublicTimePointOperation
            - `endpointBehavior` string: A string describing the behavior of the endpoint in the context of the time point operation.
            - `includeObjectsWithNoValueSet` boolean, required: A boolean indicating whether to include objects that have no value set for the time point.
            - `operationType` 'TIME_POINT', required: A string indicating the type of operation, which is 'TIME_POINT' by default.
            - `operator` string, required: A string representing the operator used in the time point operation.
            - `propertyParser` string: A string representing the parser used for the property in the time point operation.
            - `timePoint` union, required: An object representing the specific time point used in the operation. It can be one of several types, such as a date point, indexed time point, or property-referenced time.
              - …
            - `type` string, required: A string indicating the specific type of the time point operation.
          - PublicRangedTimeOperation
            - `includeObjectsWithNoValueSet` boolean, required: A boolean indicating whether objects with no value set should be included in the operation.
            - `lowerBoundEndpointBehavior` string: A string specifying the behavior of the lower bound endpoint in the time range.
            - `lowerBoundTimePoint` union, required: An object representing the lower bound time point of the range, which can be a date point, indexed time point, or property-referenced time.
              - …
            - `operationType` string, required: A string indicating the operation type, which is related to time range operations.
            - `operator` string, required: A string representing the operator used in the time range operation.
            - `propertyParser` string: A string that defines the property parser used in the operation.
            - `type` 'TIME_RANGED', required: A string indicating the type of operation, which is 'TIME_RANGED'.
            - `upperBoundEndpointBehavior` string: A string specifying the behavior of the upper bound endpoint in the time range.
            - `upperBoundTimePoint` union, required: An object representing the upper bound time point of the range, which can be a date point, indexed time point, or property-referenced time.
              - …
      - PublicAssociationFilterBranch
        - `associationCategory` string, required: A string that categorizes the type of association being filtered.
        - `associationTypeId` integer, required: An integer representing the type ID of the association.
        - `filterBranchOperator` string, required: A string that defines the logical operator for combining filters within this branch.
        - `filterBranchType` 'ASSOCIATION', required: A string indicating the type of filter branch, which is 'ASSOCIATION' for this component.
        - `filterBranches` union[], required: An array of nested filter branches, allowing for complex logical groupings of filters.
          - union
            - PublicOrFilterBranch
              - …
            - PublicAndFilterBranch
              - …
            - PublicNotAllFilterBranch
              - …
            - PublicNotAnyFilterBranch
              - …
            - PublicRestrictedFilterBranch
              - …
            - PublicUnifiedEventsFilterBranch
              - …
            - PublicAssociationFilterBranch (recursive)
        - `filters` union[], required: An array of filters applied within this branch, each defining specific criteria for filtering associations.
          - union
            - PublicPropertyFilter
              - …
            - PublicAssociationInListFilter
              - …
            - PublicPageViewAnalyticsFilter
              - …
            - PublicCtaAnalyticsFilter
              - …
            - PublicEventAnalyticsFilter
              - …
            - PublicFormSubmissionFilter
              - …
            - PublicFormSubmissionOnPageFilter
              - …
            - PublicIntegrationEventFilter
              - …
            - PublicEmailSubscriptionFilter
              - …
            - PublicCommunicationSubscriptionFilter
              - …
            - PublicSurveyMonkeyFilter
              - …
            - PublicSurveyMonkeyValueFilter
              - …
            - PublicWebinarFilter
              - …
            - PublicEmailEventFilter
              - …
            - PublicPrivacyAnalyticsFilter
              - …
            - PublicAdsSearchFilter
              - …
            - PublicAdsTimeFilter
              - …
            - PublicInListFilter
              - …
            - PublicUnifiedEventsFilter
              - …
            - PublicConstantFilter
              - …
        - `objectTypeId` string, required: A string representing the type ID of the object involved in the association.
        - `operator` string, required: A string that specifies the operator used in the filter logic.
    - `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.
    - `listPermissions` PublicListPermissions
      - `teamsWithEditAccess` integer[], required: An array of integers representing the IDs of teams that have edit access to the list.
      - `usersWithEditAccess` integer[], required: An array of integers representing the IDs of users that have edit access to the list.
    - `listVersion` integer, required: An integer indicating the version of the list.
    - `membershipSettings` PublicMembershipSettings
      - `includeUnassigned` boolean: A boolean indicating whether to include unassigned records in the membership settings.
      - `membershipTeamId` integer: A string representing the unique identifier of the team associated with the membership settings.
    - `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.
    - `size` integer: An integer representing the size of 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.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `e1dd745172d1`: 508 breaking, 2 info
  - added `#/components/schemas/PublicComparativeNumberPropertyOperation` to the `lists/items/filterBranch/oneOf[subschema #1: OR]/filterBranches/items/oneOf[subschema #2: AND]/filterBranches/items/oneOf[subschema #3: NOT_ALL]/filterBranches/items/oneOf[subschema #4: NOT_ANY]/filterBranches/items/oneOf[subschema #5: RESTRICTED]/filterBranches/items/oneOf[subschema #6: UNIFIED_EVENTS]/filterBranches/items/oneOf[subschema #7: ASSOCIATION]/filters/items/oneOf[subschema #12: SURVEY_MONKEY_VALUE]/valueComparison` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PublicComparativeNumberPropertyOperation` to the `lists/items/filterBranch/oneOf[subschema #1: OR]/filterBranches/items/oneOf[subschema #2: AND]/filterBranches/items/oneOf[subschema #3: NOT_ALL]/filterBranches/items/oneOf[subschema #4: NOT_ANY]/filterBranches/items/oneOf[subschema #5: RESTRICTED]/filterBranches/items/oneOf[subschema #6: UNIFIED_EVENTS]/filterBranches/items/oneOf[subschema #7: ASSOCIATION]/filters/items/oneOf[subschema #19: UNIFIED_EVENTS]/filterLines/items/operation` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PublicComparativeNumberPropertyOperation` to the `lists/items/filterBranch/oneOf[subschema #1: OR]/filterBranches/items/oneOf[subschema #2: AND]/filterBranches/items/oneOf[subschema #3: NOT_ALL]/filterBranches/items/oneOf[subschema #4: NOT_ANY]/filterBranches/items/oneOf[subschema #5: RESTRICTED]/filterBranches/items/oneOf[subschema #6: UNIFIED_EVENTS]/filterBranches/items/oneOf[subschema #7: ASSOCIATION]/filters/items/oneOf[subschema #1: PROPERTY]/operation` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PublicComparativeNumberPropertyOperation` to the `lists/items/filterBranch/oneOf[subschema #1: OR]/filterBranches/items/oneOf[subschema #2: AND]/filterBranches/items/oneOf[subschema #3: NOT_ALL]/filterBranches/items/oneOf[subschema #4: NOT_ANY]/filterBranches/items/oneOf[subschema #5: RESTRICTED]/filterBranches/items/oneOf[subschema #6: UNIFIED_EVENTS]/filterBranches/items/oneOf[subschema #7: ASSOCIATION]/filters/items/oneOf[subschema #8: INTEGRATION_EVENT]/filterLines/items/operation` response property `oneOf` list for the response status `200`
  - …506 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/hubspot/apis/crm-lists/changes/crm/lists/2026-09/get.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)
