Search files

Search for files in the HubSpot account using various filters and criteria. This endpoint allows you to specify multiple query parameters to narrow down the search results based on properties like creation date, size, type, and more. It supports pagination and sorting to manage large sets of data effectively.

get/files/2026-09-beta/files/search

Query parameters

afterstring

A cursor token for pagination, indicating the last successfully read resource.

allowsAnonymousAccessboolean

Filter files based on whether they allow anonymous access.

beforestring

A cursor token for pagination, indicating the first successfully read resource.

createdAtstring date-time

Filter files created at this specific date and time.

createdAtGtestring date-time

Filter files created on or after this date and time.

createdAtLtestring date-time

Filter files created on or before this date and time.

encodingstring

Filter files by their encoding type.

expiresAtstring date-time

Filter files by their expiration date and time.

expiresAtGtestring date-time

Filter files expiring on or after this date and time.

expiresAtLtestring date-time

Filter files expiring on or before this date and time.

extensionstring

Filter files by their file extension.

fileMd5string

Filter files by their MD5 hash.

heightinteger

Filter files by their exact height.

heightGteinteger

Filter files with height greater than or equal to this value.

heightLteinteger

Filter files with height less than or equal to this value.

idGteinteger

Filter files with IDs greater than or equal to this value.

idLteinteger

Filter files with IDs less than or equal to this value.

idsinteger[]

A list of file IDs to filter the results.

isUsableInContentboolean

Filter files based on whether they are usable in content.

limitinteger

The maximum number of results to display per page.

namestring

Filter files by name.

parentFolderIdsinteger[]

A list of parent folder IDs to filter the results.

pathstring

Filter files by their path.

propertiesstring[]

A list of property names to include in the response.

sizeinteger

Filter files by their exact size.

sizeGteinteger

Filter files with size greater than or equal to this value.

sizeLteinteger

Filter files with size less than or equal to this value.

sortstring[]

A list of fields to sort the results by.

typestring

Filter files by their type.

updatedAtstring date-time

Filter files updated at this specific date and time.

updatedAtGtestring date-time

Filter files updated on or after this date and time.

updatedAtLtestring date-time

Filter files updated on or before this date and time.

urlstring

Filter files by their URL.

widthinteger

Filter files by their exact width.

widthGteinteger

Filter files with width greater than or equal to this value.

widthLteinteger

Filter files with width less than or equal to this value.

Response

successful operation