v1
latestOpenAPI 3.0.02026-07-2484509641.9 KBList 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 parameters
Page number for the results.
Number of records to return per page. Default is 25.
Field based on which to sort the results. Use '-' prefix for descending order. Allowed values: name, createdAt, updatedAt, audienceCount, recentlyViewed
Filter folders by userId of the creator.
Filter folders by userId of the last updated person.
Search folders by name (partial match).
Filter folders created after a specific date. Eg: 2025-10-10T17:08:00Z
Filter folders created before a specific date. Eg: 2025-10-10T17:08:00Z
Filter folders updated after a specific date. Eg: 2025-10-10T17:08:00Z
Filter folders updated before a specific date. Eg: 2025-10-10T17:08:00Z
Response
Success