---
title: "List Folders"
method: GET
path: "/studio/v1/folders"
tags: ["Audiences"]
---

# List Folders

`GET /studio/v1/folders`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/studio/v1/folders`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:audience:read`

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]` integer
- `page[size]` integer
- `sort` string
- `filter[createdById]` integer[]
- `filter[updatedById]` integer[]
- `filter[searchText]` string
- `filter[createdAfter]` string, date-time
- `filter[createdBefore]` string, date-time
- `filter[updatedAfter]` string, date-time
- `filter[updatedBefore]` string, date-time

## Response `200`

Success

- FolderJsonApiList: JSON API model for Folder List.
  - `data` Folder[], required: The primary data of the document
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` FolderAttributes, required: Attributes for a folder that organizes audiences in GTM Studio.
      - `name` string, required: Display name of the folder. Required on create.
      - `description` string: Optional free-text description of the folder's purpose.
      - `notes` string: Optional notes about the folder for internal reference.
      - `starred` boolean: Whether the folder is starred for quick access. Optional; defaults to `false`.
      - `audiences` string[]: List of `audienceId` values for the audiences contained in this folder. Read-only; updated automatically as audiences are added or moved.
    - `meta` FolderMeta: Metadata for Folder model.
      - `createdAt` string, date-time, required: The timestamp when the resource was created
      - `createdById` integer, required: Id of the user who created the resource
      - `createdByName` string, required: Name of the user who created the resource
      - `updatedAt` string, date-time, required: The timestamp when the resource was last updated
      - `updatedById` integer, required: Id of the user who last updated the resource
      - `updatedByName` string, required: Name of the user who last updated the resource
  - `meta` Pagination: Pagination details for paginated responses.
    - `page` Page, required: Page details for paginated responses.
      - `size` integer, required: Number of items per page
      - `number` integer, required: Current page number
    - `total` integer, required: Total number of items available
  - `links` FoldersPagingLinks: Paging links for Folder list.
    - `first` string, uri: A link to the first page of data
    - `last` string, uri: A link to the last page of data
    - `prev` string, uri: A link to the previous page of data
    - `next` string, uri: A link to the next page of data

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/revisions/93a0bebaaac8?raw)