---
title: "Get Specific Folder"
method: GET
path: "/studio/v1/folders/{folderId}"
tags: ["Audiences"]
---

# Get Specific Folder

`GET /studio/v1/folders/{folderId}`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/studio/v1/folders/{folderId}`
- 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 the full state of a single folder by its `folderId`.
Returns all folder attributes — name, starred status, description, notes, creation and update timestamps, and the list of `audienceId` values contained in the folder.
Use this endpoint to inspect a folder's contents before operating on its audiences, or to verify folder state after an update.
Returns `200` with the folder resource.
Returns `404` if no folder matches the provided `folderId`.

## Path parameters

- `folderId` string, uuid, required

## Response `200`

Success

- FolderJsonApiModel: JSON API model for Folder.
  - `data` Folder, required: Folder request resource.
    - `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

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `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)