Lists

Retrieves and describes all lists in your HubSpot account.

Columns


Name	Type	References	Filterable	Description
Id [KEY]	Long		True	Unique numeric identifier for the list.
Name	String		True	Human-readable name of the list.
ObjectTypeId	String			Object type the list applies to (for example, ‘0-1’).
Size	Int			Current count of records in the list.
FolderName	String			Name of the folder where the list is organized (if any).
ProcessingType	String		True	Type of list processing. The allowed values are SNAPSHOT, MANUAL, DYNAMIC.
ProcessingStatus	String			Current state of list processing (for example, 'PROCESSING', 'COMPLETE').
FiltersUpdatedAt	Datetime			Timestamp when the list’s filter criteria were last modified.
LastRecordAddedAt	Datetime			Timestamp when the most recent record was added to the list.
LastRecordRemovedAt	Datetime			Timestamp when the most recent record was removed from the list.
ReferenceCount	Int			Number of other HubSpot assets referencing this list.
Version	Int			Version number, incremented each time the list definition changes.
CreatedById	Long			User ID of the account that created the list.
UpdatedById	Long			User ID of the account that last updated the list.
CreatedAt	Datetime			Timestamp when the list was originally created.
UpdatedAt	Datetime			Timestamp of the most recent update to the list metadata.