List Folders

Retrieves a paginated list of all folders, with optional filtering and sorting. Use this endpoint to browse the folder structure or to find a folderId before creating or moving an audience. Filter by createdById, updatedById, searchText (partial name match), or date ranges (createdAfter, createdBefore, updatedAfter, updatedBefore). Use sort to order results by name, createdAt, updatedAt, audienceCount, or recentlyViewed; prefix with - for descending order (default: -updatedAt). Use page[number] and page[size] (default 25, max 100) to paginate. Returns 200 with a paginated array of folder resources including audiences (list of audience IDs in each folder) and navigation links. Returns 400 if filter or sort parameters are invalid.

Query Params
int32
≥ 1
Defaults to 1

Page number for the results.

int32
1 to 100
Defaults to 25

Number of records to return per page. Default is 25.

string
Defaults to -updatedAt

Field based on which to sort the results. Use '-' prefix for descending order. Allowed values: name, createdAt, updatedAt, audienceCount, recentlyViewed

filter[createdById]
array of uint32s

Filter folders by userId of the creator.

filter[createdById]
filter[updatedById]
array of uint32s

Filter folders by userId of the last updated person.

filter[updatedById]
string

Search folders by name (partial match).

date-time

Filter folders created after a specific date. Eg: 2025-10-10T17:08:00Z

date-time

Filter folders created before a specific date. Eg: 2025-10-10T17:08:00Z

date-time

Filter folders updated after a specific date. Eg: 2025-10-10T17:08:00Z

date-time

Filter folders updated before a specific date. Eg: 2025-10-10T17:08:00Z

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.api+json