---
title: "Retrieve list"
method: GET
path: "/crm/lists/2026-09/{listId}"
tags: ["Basic"]
---

# Retrieve list

`GET /crm/lists/2026-09/{listId}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/lists/2026-09/{listId}`
- 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 details of a specific list in your HubSpot account using the list's unique identifier. This endpoint allows you to optionally include filters associated with the list in the response.

## Path parameters

- `listId` string, required

## Query parameters

- `includeFilters` boolean

## Response `200`

successful operation

- ListFetchResponse
  - `list` PublicObjectList, 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 `list/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 `list/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 `list/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 `list/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/:listId/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)
