v4

latestOpenAPI 3.0.12026-07-1329109219.3 KB
Search

post/crm/lists/2026-09/search

Request body

additionalPropertiesstring[] required

The property names of any additional list properties to include in the response. Properties that do not exist or that are empty for a particular list are not included in the response.

By default, all requests will fetch the following properties for each list: hs_list_size, hs_last_record_added_at, hs_last_record_removed_at, hs_folder_name, and hs_list_reference_count.

countinteger

The number of lists to include in the response. Defaults to 20 if no value is provided. The max count is 500.

listIdsstring[] required

The listIds that will be used to filter results by listId. If values are provided, then the response will only include results that have a listId in this array.

If no value is provided, or if an empty list is provided, then the results will not be filtered by listId.

objectTypeIdstring
offsetinteger required

Value used to paginate through lists. The offset provided in the response can be used in the next request to fetch the next page of results. Defaults to 0 if no offset is provided.

processingTypesstring[] required

The processingTypes that will be used to filter results by processingType. If values are provided, then the response will only include results that have a processingType in this array.

If no value is provided, or if an empty list is provided, then results will not be filtered by processingType.

Valid processingTypes are: MANUAL, SNAPSHOT, or DYNAMIC.

querystring

The query that will be used to search for lists by list name. If no query is provided, then the results will include all lists.

sortstring

Sort field and order

Response

successful operation

hasMoreboolean required

Whether or not there are more results to page through.

offsetinteger required

Value to be passed in a future request to paginate through list search results.

totalinteger required

The total number of lists that match the search criteria.