---
title: "List Folders"
method: GET
path: "/mailbox/{mailbox_uid}/folders"
---

# List Folders

`GET /mailbox/{mailbox_uid}/folders`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/mailbox/{mailbox_uid}/folders`
- Auth: API key in header `x-api-key`

List all folders for a Mail Box. folder_id is a globally unique object identifier for Microsoft accounts and an email address for Google accounts.

## Path parameters

- `mailbox_uid` string, required

## Query parameters

- `limit` integer
- `single_level` boolean

## Response `200`

- object
  - `type` string
  - `data` object[]
    - `folder_id` string
    - `background_color` string
    - `child_count` integer
    - `name` string
    - `object` string
    - `parent_id` string
    - `single_level` boolean
    - `system_folder` boolean
    - `text_color` string
    - `total_count` integer
    - `unread_count` integer
    - `attributes` string[]

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/mailbox/:mailbox_uid/folders/get.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)