---
title: "List email folders and counts"
method: GET
path: "/api/emails/{address}/folders"
tags: ["Email"]
---

# List email folders and counts

`GET /api/emails/{address}/folders`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/folders`
- Auth: HTTP bearer

Return server-derived counts for system folders and virtual views, plus lifecycle capabilities for the mailbox backend.

## Path parameters

- `address` string, required

## Response `200`

Folder counts

- object
  - `folders` object[]
    - `id` 'inbox' | 'archive' | 'sent' | 'drafts' | 'spam' | 'trash'
    - `total` integer
    - `unread` integer
  - `views` object[]
    - `id` 'starred' | 'all' | 'needs_human' | 'scheduled'
    - `total` integer
    - `unread` integer
  - `capabilities` object

## Other responses

- `404`: Mailbox not found

## Changes

- **2026-10-19** `7679f8159533`: 1 warning
  - added the new `scheduled` enum value to the `views/items/id` response property for the response status `200`

[Operation history](https://skmtc.dev/domani/apis/domani-run-api/changes/api/emails/:address/folders/get.md)

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)