--- title: "GET /crm/lists/2026-03/{listId}" method: GET path: "/crm/lists/2026-03/{listId}" tags: ["Basic"] --- # GET /crm/lists/2026-03/{listId} `GET /crm/lists/2026-03/{listId}` ## Path parameters - `listId` string, required ## Query parameters - `includeFilters` boolean ## Response `200` successful operation - CrmListsListFetchResponse - `list` CrmListsPublicObjectList, required - `createdAt` string, date-time — The time when the list was created. - `createdById` string — The ID of the user that created the list. - `deletedAt` string, date-time — The time when the list was deleted. - `filterBranch` union — Defines the filter criteria for the list, allowing for complex logical operations and nested filter branches to determine list membership. - CrmListsPublicOrFilterBranch - `filterBranchOperator` string, required — The logical operator used to combine the filters within the branch (OR). - `filterBranchType` 'OR', required — The type of the filter branch (OR). - `filterBranches` union[], required - union - CrmListsPublicOrFilterBranch — recursive - CrmListsPublicAndFilterBranch - … - CrmListsPublicNotAllFilterBranch - … - CrmListsPublicNotAnyFilterBranch - … - CrmListsPublicRestrictedFilterBranch - … - CrmListsPublicUnifiedEventsFilterBranch - … - CrmListsPublicAssociationFilterBranch - … - `filters` union[], required - union - CrmListsPublicPropertyFilter - … - CrmListsPublicAssociationInListFilter - … - CrmListsPublicPageViewAnalyticsFilter - … - CrmListsPublicCtaAnalyticsFilter - … - CrmListsPublicEventAnalyticsFilter - … - CrmListsPublicFormSubmissionFilter - … - CrmListsPublicFormSubmissionOnPageFilter - … - CrmListsPublicIntegrationEventFilter - … - CrmListsPublicEmailSubscriptionFilter - … - CrmListsPublicCommunicationSubscriptionFilter - … - CrmListsPublicSurveyMonkeyFilter - … - CrmListsPublicSurveyMonkeyValueFilter - … - CrmListsPublicWebinarFilter - … - CrmListsPublicEmailEventFilter - … - CrmListsPublicPrivacyAnalyticsFilter - … - CrmListsPublicAdsSearchFilter - … - CrmListsPublicAdsTimeFilter - … - CrmListsPublicInListFilter - … - CrmListsPublicUnifiedEventsFilter - … - CrmListsPublicConstantFilter - … - CrmListsPublicAndFilterBranch - `filterBranchOperator` string, required — Filter branch operator (AND) - `filterBranchType` 'AND', required — Type of filter branch (AND) - `filterBranches` union[], required - union - CrmListsPublicOrFilterBranch - … - CrmListsPublicAndFilterBranch — recursive - CrmListsPublicNotAllFilterBranch - … - CrmListsPublicNotAnyFilterBranch - … - CrmListsPublicRestrictedFilterBranch - … - CrmListsPublicUnifiedEventsFilterBranch - … - CrmListsPublicAssociationFilterBranch - … - `filters` union[], required - union - CrmListsPublicPropertyFilter - … - CrmListsPublicAssociationInListFilter - … - CrmListsPublicPageViewAnalyticsFilter - … - CrmListsPublicCtaAnalyticsFilter - … - CrmListsPublicEventAnalyticsFilter - … - CrmListsPublicFormSubmissionFilter - … - CrmListsPublicFormSubmissionOnPageFilter - … - CrmListsPublicIntegrationEventFilter - … - CrmListsPublicEmailSubscriptionFilter - … - CrmListsPublicCommunicationSubscriptionFilter - … - CrmListsPublicSurveyMonkeyFilter - … - CrmListsPublicSurveyMonkeyValueFilter - … - CrmListsPublicWebinarFilter - … - CrmListsPublicEmailEventFilter - … - CrmListsPublicPrivacyAnalyticsFilter - … - CrmListsPublicAdsSearchFilter - … - CrmListsPublicAdsTimeFilter - … - CrmListsPublicInListFilter - … - CrmListsPublicUnifiedEventsFilter - … - CrmListsPublicConstantFilter - … - CrmListsPublicNotAllFilterBranch - `filterBranchOperator` string, required — The operator used to combine filters within the branch (NOT_ALL). - `filterBranchType` 'NOT_ALL', required — The type of the filter branch (NOT_ALL). - `filterBranches` union[], required - union - CrmListsPublicOrFilterBranch - … - CrmListsPublicAndFilterBranch - … - CrmListsPublicNotAllFilterBranch — recursive - CrmListsPublicNotAnyFilterBranch - … - CrmListsPublicRestrictedFilterBranch - … - CrmListsPublicUnifiedEventsFilterBranch - … - CrmListsPublicAssociationFilterBranch - … - `filters` union[], required - union - CrmListsPublicPropertyFilter - … - CrmListsPublicAssociationInListFilter - … - CrmListsPublicPageViewAnalyticsFilter - … - CrmListsPublicCtaAnalyticsFilter - … - CrmListsPublicEventAnalyticsFilter - … - CrmListsPublicFormSubmissionFilter - … - CrmListsPublicFormSubmissionOnPageFilter - … - CrmListsPublicIntegrationEventFilter - … - CrmListsPublicEmailSubscriptionFilter - … - CrmListsPublicCommunicationSubscriptionFilter - … - CrmListsPublicSurveyMonkeyFilter - … - CrmListsPublicSurveyMonkeyValueFilter - … - CrmListsPublicWebinarFilter - … - CrmListsPublicEmailEventFilter - … - CrmListsPublicPrivacyAnalyticsFilter - … - CrmListsPublicAdsSearchFilter - … - CrmListsPublicAdsTimeFilter - … - CrmListsPublicInListFilter - … - CrmListsPublicUnifiedEventsFilter - … - CrmListsPublicConstantFilter - … - CrmListsPublicNotAnyFilterBranch - `filterBranchOperator` string, required — Specifies the logical operator used to combine filters within the branch (NOT_ANY). - `filterBranchType` 'NOT_ANY', required — Indicates the type of filter branch (NOT_ANY). - `filterBranches` union[], required - union - CrmListsPublicOrFilterBranch - … - CrmListsPublicAndFilterBranch - … - CrmListsPublicNotAllFilterBranch - … - CrmListsPublicNotAnyFilterBranch — recursive - CrmListsPublicRestrictedFilterBranch - … - CrmListsPublicUnifiedEventsFilterBranch - … - CrmListsPublicAssociationFilterBranch - … - `filters` union[], required - union - CrmListsPublicPropertyFilter - … - CrmListsPublicAssociationInListFilter - … - CrmListsPublicPageViewAnalyticsFilter - … - CrmListsPublicCtaAnalyticsFilter - … - CrmListsPublicEventAnalyticsFilter - … - CrmListsPublicFormSubmissionFilter - … - CrmListsPublicFormSubmissionOnPageFilter - … - CrmListsPublicIntegrationEventFilter - … - CrmListsPublicEmailSubscriptionFilter - … - CrmListsPublicCommunicationSubscriptionFilter - … - CrmListsPublicSurveyMonkeyFilter - … - CrmListsPublicSurveyMonkeyValueFilter - … - CrmListsPublicWebinarFilter - … - CrmListsPublicEmailEventFilter - … - CrmListsPublicPrivacyAnalyticsFilter - … - CrmListsPublicAdsSearchFilter - … - CrmListsPublicAdsTimeFilter - … - CrmListsPublicInListFilter - … - CrmListsPublicUnifiedEventsFilter - … - CrmListsPublicConstantFilter - … - CrmListsPublicRestrictedFilterBranch - `filterBranchOperator` string, required — The logical operator used to combine filters within the restricted filter branch. - `filterBranchType` 'RESTRICTED', required — Specifies the type of the filter branch (RESTRICTED). - `filterBranches` union[], required - union - CrmListsPublicOrFilterBranch - … - CrmListsPublicAndFilterBranch - … - CrmListsPublicNotAllFilterBranch - … - CrmListsPublicNotAnyFilterBranch - … - CrmListsPublicRestrictedFilterBranch — recursive - CrmListsPublicUnifiedEventsFilterBranch - … - CrmListsPublicAssociationFilterBranch - … - `filters` union[], required - union - CrmListsPublicPropertyFilter - … - CrmListsPublicAssociationInListFilter - … - CrmListsPublicPageViewAnalyticsFilter - … - CrmListsPublicCtaAnalyticsFilter - … - CrmListsPublicEventAnalyticsFilter - … - CrmListsPublicFormSubmissionFilter - … - CrmListsPublicFormSubmissionOnPageFilter - … - CrmListsPublicIntegrationEventFilter - … - CrmListsPublicEmailSubscriptionFilter - … - CrmListsPublicCommunicationSubscriptionFilter - … - CrmListsPublicSurveyMonkeyFilter - … - CrmListsPublicSurveyMonkeyValueFilter - … - CrmListsPublicWebinarFilter - … - CrmListsPublicEmailEventFilter - … - CrmListsPublicPrivacyAnalyticsFilter - … - CrmListsPublicAdsSearchFilter - … - CrmListsPublicAdsTimeFilter - … - CrmListsPublicInListFilter - … - CrmListsPublicUnifiedEventsFilter - … - CrmListsPublicConstantFilter - … - CrmListsPublicUnifiedEventsFilterBranch - `coalescingRefineBy` union — Specifies the criteria for refining the filter by coalescing. - CrmListsPublicNumOccurrencesRefineBy - `maxOccurrences` integer — The maximum number of occurrences allowed. - `minOccurrences` integer — The minimum number of occurrences required. - `type` 'NUM_OCCURRENCES', required — The type of refinement (NUM_OCCURRENCES). - CrmListsPublicSetOccurrencesRefineBy - `setType` string, required — Indicates the specific set type used in the refinement (ALL, ALL_INCLUDE_EMPTY, ANY, NONE, NONE_EXCLUDE_EMPTY, ANY_INCLUDE_EMPTY). - `type` 'SET_OCCURRENCES', required — Specifies the type of refinement (SET_OCCURRENCES). - CrmListsPublicRelativeComparativeTimestampRefineBy - `comparison` string, required — Defines the comparison operation to be used in the refinement (BEFORE, AFTER). - `timeOffset` CrmListsPublicTimeOffset, required - … - `type` 'RELATIVE_COMPARATIVE', required — Specifies the type of refinement, (RELATIVE_COMPARATIVE). - CrmListsPublicRelativeRangedTimestampRefineBy - `lowerBoundOffset` CrmListsPublicTimeOffset, required - … - `rangeType` string, required — Specifies the type of range for the refinement criteria (BETWEEN, NOT_BETWEEN). - `type` 'RELATIVE_RANGED', required — Indicates the type of refinement (RELATIVE_RANGED). - `upperBoundOffset` CrmListsPublicTimeOffset, required - … - CrmListsPublicAbsoluteComparativeTimestampRefineBy - `comparison` string, required — Timestamp comparison options (BEFORE, AFTER) - `timestamp` integer, required — Timestamp to be used in refine by criteria - `type` 'ABSOLUTE_COMPARATIVE', required — type of refine by criteria (ABSOLUTE_COMPARATIVE) - CrmListsPublicAbsoluteRangedTimestampRefineBy - `lowerTimestamp` integer, required — Lower range timestamp of refinement criteria - `rangeType` string, required — Type of range of refinement critaria (BETWEEN, NOT_BETWEEN) - `type` 'ABSOLUTE_RANGED', required — type of refine by criteria (ABSOLUTE_RANGED) - `upperTimestamp` integer, required — Upper range timestamp of refinement criteria - CrmListsPublicAllHistoryRefineBy - `type` 'ALL_HISTORY', required — Type of refine by (ALL_HISTORY) - CrmListsPublicTimePointOperation - `endpointBehavior` string — Describes the behavior at the endpoint of the time point operation. - `includeObjectsWithNoValueSet` boolean, required — Indicates whether objects with no value set for the property should be included in the operation. - `operationType` 'TIME_POINT', required — Specifies the type of operation (TIME_POINT). - `operator` string, required — Specifies the operation to be applied within the time point operation (IS_BEFORE, IS_AFTER). - `propertyParser` string — Specifies the parser used for interpreting the property in the operation. - `timePoint` union, required — Defines the specific point in time for the operation, which can be a date, indexed time, or property-referenced time. - … - `type` string, required — Defines the type of operation being performed. - CrmListsPublicRangedTimeOperation - `includeObjectsWithNoValueSet` boolean, required — Indicates whether objects with no value set for the property should be included in the operation. - `lowerBoundEndpointBehavior` string — Describes the behavior at the lower bound endpoint of the time range. - `lowerBoundTimePoint` union, required — Defines the lower bound time point for the operation. - … - `operationType` 'TIME_RANGED', required — Specifies the type of operation (TIME_RANGED). - `operator` string, required — Defines the operation to be applied within the time range (IS_BETWEEN, IS_NOT_BETWEEN). - `propertyParser` string — Specifies the parser used for the property in the operation. - `type` 'TIME_RANGED', required — Specifies the type of operation (TIME_RANGED). - `upperBoundEndpointBehavior` string — Describes the behavior at the upper bound endpoint of the time range. - `upperBoundTimePoint` union, required — Defines the upper bound time point for the operation. - … - `eventTypeId` string, required — The identifier for the type of event associated with the filter branch. - `filterBranchOperator` string, required — The logical operator used to combine filters within the branch (AND). - `filterBranchType` 'UNIFIED_EVENTS', required — The type of the filter branch (UNIFIED_EVENTS). - `filterBranches` union[], required - union - CrmListsPublicOrFilterBranch - … - CrmListsPublicAndFilterBranch - … - CrmListsPublicNotAllFilterBranch - … - CrmListsPublicNotAnyFilterBranch - … - CrmListsPublicRestrictedFilterBranch - … - CrmListsPublicUnifiedEventsFilterBranch — recursive - CrmListsPublicAssociationFilterBranch - … - `filters` union[], required - union - CrmListsPublicPropertyFilter - … - CrmListsPublicAssociationInListFilter - … - CrmListsPublicPageViewAnalyticsFilter - … - CrmListsPublicCtaAnalyticsFilter - … - CrmListsPublicEventAnalyticsFilter - … - CrmListsPublicFormSubmissionFilter - … - CrmListsPublicFormSubmissionOnPageFilter - … - CrmListsPublicIntegrationEventFilter - … - CrmListsPublicEmailSubscriptionFilter - … - CrmListsPublicCommunicationSubscriptionFilter - … - CrmListsPublicSurveyMonkeyFilter - … - CrmListsPublicSurveyMonkeyValueFilter - … - CrmListsPublicWebinarFilter - … - CrmListsPublicEmailEventFilter - … - CrmListsPublicPrivacyAnalyticsFilter - … - CrmListsPublicAdsSearchFilter - … - CrmListsPublicAdsTimeFilter - … - CrmListsPublicInListFilter - … - CrmListsPublicUnifiedEventsFilter - … - CrmListsPublicConstantFilter - … - `operator` 'HAS_COMPLETED' | 'HAS_NOT_COMPLETED', required — Defines the operation to be applied within the filter branch (HAS_COMPLETED, HAS_NOT_COMPLETED). - `pruningRefineBy` union - CrmListsPublicNumOccurrencesRefineBy - `maxOccurrences` integer — The maximum number of occurrences allowed. - `minOccurrences` integer — The minimum number of occurrences required. - `type` 'NUM_OCCURRENCES', required — The type of refinement (NUM_OCCURRENCES). - CrmListsPublicSetOccurrencesRefineBy - `setType` string, required — Indicates the specific set type used in the refinement (ALL, ALL_INCLUDE_EMPTY, ANY, NONE, NONE_EXCLUDE_EMPTY, ANY_INCLUDE_EMPTY). - `type` 'SET_OCCURRENCES', required — Specifies the type of refinement (SET_OCCURRENCES). - CrmListsPublicRelativeComparativeTimestampRefineBy - `comparison` string, required — Defines the comparison operation to be used in the refinement (BEFORE, AFTER). - `timeOffset` CrmListsPublicTimeOffset, required - … - `type` 'RELATIVE_COMPARATIVE', required — Specifies the type of refinement, (RELATIVE_COMPARATIVE). - CrmListsPublicRelativeRangedTimestampRefineBy - `lowerBoundOffset` CrmListsPublicTimeOffset, required - … - `rangeType` string, required — Specifies the type of range for the refinement criteria (BETWEEN, NOT_BETWEEN). - `type` 'RELATIVE_RANGED', required — Indicates the type of refinement (RELATIVE_RANGED). - `upperBoundOffset` CrmListsPublicTimeOffset, required - … - CrmListsPublicAbsoluteComparativeTimestampRefineBy - `comparison` string, required — Timestamp comparison options (BEFORE, AFTER) - `timestamp` integer, required — Timestamp to be used in refine by criteria - `type` 'ABSOLUTE_COMPARATIVE', required — type of refine by criteria (ABSOLUTE_COMPARATIVE) - CrmListsPublicAbsoluteRangedTimestampRefineBy - `lowerTimestamp` integer, required — Lower range timestamp of refinement criteria - `rangeType` string, required — Type of range of refinement critaria (BETWEEN, NOT_BETWEEN) - `type` 'ABSOLUTE_RANGED', required — type of refine by criteria (ABSOLUTE_RANGED) - `upperTimestamp` integer, required — Upper range timestamp of refinement criteria - CrmListsPublicAllHistoryRefineBy - `type` 'ALL_HISTORY', required — Type of refine by (ALL_HISTORY) - CrmListsPublicTimePointOperation - `endpointBehavior` string — Describes the behavior at the endpoint of the time point operation. - `includeObjectsWithNoValueSet` boolean, required — Indicates whether objects with no value set for the property should be included in the operation. - `operationType` 'TIME_POINT', required — Specifies the type of operation (TIME_POINT). - `operator` string, required — Specifies the operation to be applied within the time point operation (IS_BEFORE, IS_AFTER). - `propertyParser` string — Specifies the parser used for interpreting the property in the operation. - `timePoint` union, required — Defines the specific point in time for the operation, which can be a date, indexed time, or property-referenced time. - … - `type` string, required — Defines the type of operation being performed. - CrmListsPublicRangedTimeOperation - `includeObjectsWithNoValueSet` boolean, required — Indicates whether objects with no value set for the property should be included in the operation. - `lowerBoundEndpointBehavior` string — Describes the behavior at the lower bound endpoint of the time range. - `lowerBoundTimePoint` union, required — Defines the lower bound time point for the operation. - … - `operationType` 'TIME_RANGED', required — Specifies the type of operation (TIME_RANGED). - `operator` string, required — Defines the operation to be applied within the time range (IS_BETWEEN, IS_NOT_BETWEEN). - `propertyParser` string — Specifies the parser used for the property in the operation. - `type` 'TIME_RANGED', required — Specifies the type of operation (TIME_RANGED). - `upperBoundEndpointBehavior` string — Describes the behavior at the upper bound endpoint of the time range. - `upperBoundTimePoint` union, required — Defines the upper bound time point for the operation. - … - CrmListsPublicAssociationFilterBranch - `associationCategory` string, required — Specifies the category of the association for the filter branch (HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED, WORK). - `associationTypeId` integer, required — Type id of the association - `filterBranchOperator` string, required — Filter branch operator (AND) - `filterBranchType` 'ASSOCIATION', required — Type of the filter branch (ASSOCIATION) - `filterBranches` union[], required - union - CrmListsPublicOrFilterBranch - … - CrmListsPublicAndFilterBranch - … - CrmListsPublicNotAllFilterBranch - … - CrmListsPublicNotAnyFilterBranch - … - CrmListsPublicRestrictedFilterBranch - … - CrmListsPublicUnifiedEventsFilterBranch - … - CrmListsPublicAssociationFilterBranch — recursive - `filters` union[], required - union - CrmListsPublicPropertyFilter - … - CrmListsPublicAssociationInListFilter - … - CrmListsPublicPageViewAnalyticsFilter - … - CrmListsPublicCtaAnalyticsFilter - … - CrmListsPublicEventAnalyticsFilter - … - CrmListsPublicFormSubmissionFilter - … - CrmListsPublicFormSubmissionOnPageFilter - … - CrmListsPublicIntegrationEventFilter - … - CrmListsPublicEmailSubscriptionFilter - … - CrmListsPublicCommunicationSubscriptionFilter - … - CrmListsPublicSurveyMonkeyFilter - … - CrmListsPublicSurveyMonkeyValueFilter - … - CrmListsPublicWebinarFilter - … - CrmListsPublicEmailEventFilter - … - CrmListsPublicPrivacyAnalyticsFilter - … - CrmListsPublicAdsSearchFilter - … - CrmListsPublicAdsTimeFilter - … - CrmListsPublicInListFilter - … - CrmListsPublicUnifiedEventsFilter - … - CrmListsPublicConstantFilter - … - `objectTypeId` string, required — The ID representing the type of object associated with the filter branch. - `operator` string, required — Defines the operation to be applied within the filter branch (IN_LIST, NOT_IN_LIST). - `filtersUpdatedAt` string, date-time — The time when the filters for this list were last updated. - `listId` string, required — The **ILS ID** of the list. - `listPermissions` CrmListsPublicListPermissions - `teamsWithEditAccess` integer[], required - `usersWithEditAccess` integer[], required - `listVersion` integer, required — The version of the list. - `membershipSettings` CrmListsPublicMembershipSettings - `includeUnassigned` boolean — Indicates whether unassigned memberships should be included. - `membershipTeamId` integer — The ID of the team associated with the membership. - `name` string, required — The name of the list. - `objectTypeId` string, required — The object type of the list. - `processingStatus` string, required — The processing status of the list. - `processingType` string, required — The processing type of the list. - `size` integer — Size of the list - `updatedAt` string, date-time — The time the list was last updated. - `updatedById` string — The ID of the user that last updated the list. ## Other responses - `default` — An error occurred. --- [API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)