Lists

Retrieves and describes all lists in your HubSpot account.

Columns


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