---
title: "Retrieve single segment folder"
method: GET
path: "/audiences/{audienceId}/folders/{folderId}"
tags: ["Folders"]
---

# Retrieve single segment folder

`GET /audiences/{audienceId}/folders/{folderId}`

Retrieve a single segment folder based on a parent segment identifier.

## Path parameters

- `audienceId` integer, required
- `folderId` integer, required

## Response `200`

Retrieves a single segment folder.

N.B. that `createdAt` can be `null`, meaning that it is not known
which user created the folder.

N.B. that `updatedAt` can be `null`, meaning that is is not known
which user last updated the folder.

- SegmentFolderReadRepresentation
  - `id` string
  - `audienceId` string — ID of the parent audience. For composable folders this carries the composable audience id; the complete-vs-composable discriminator lives on the parent audience entity, not on the folder.
  - `name` string
  - `description` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `createdBy` union
    - User
      - `id` string
      - `td_user_id` string
      - `name` string
    - NullValue, nullable
      - `thisKeyNeverHit` string
  - `updatedBy` union
    - User
      - `id` string
      - `td_user_id` string
      - `name` string
    - NullValue, nullable
      - `thisKeyNeverHit` string

---

[API](https://skmtc.net/treasure/apis/cdp-api.md) · [All operations](https://skmtc.net/treasure/apis/cdp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/cdp-api/revisions/24caa8eb809b/schema)