---
title: "Retrieve list of segment folders"
method: GET
path: "/audiences/{audienceId}/folders"
tags: ["Parent Segments"]
---

# Retrieve list of segment folders

`GET /audiences/{audienceId}/folders`

Retrieve a list of segment folders based on a parent segment's identifier.

## Path parameters

- `audienceId` integer, required

## Response `200`

Retrieves a list of segment folders.

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)