v14

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-279719892.3 MB
Search

post/crm/lists/2026-03/search

Request body

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

ILS list ids to be included in search results. If not specified, all lists matching other criteria will be included

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

List processing types to be included in search results. If not specified, all lists with all processing types will be included.

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

additional_filter_propertiesstring[]

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.

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.