---
title: "List the threads of a folder"
method: GET
path: "/inboxes/{id}/threads"
tags: ["Inboxes"]
---

# List the threads of a folder

`GET /inboxes/{id}/threads`

## Request

- Base URL: `https://sending.dev/api/v1`
- URL: `https://sending.dev/api/v1/inboxes/{id}/threads`
- Auth: HTTP bearer

`folder` parameter (default `inbox`). Required scope: `inbox:read`. (`inbox:*` scopes cannot be assigned from the UI: they require a full-access `*` key).

## Path parameters

- `id` string, required: Inbox ID.

## Query parameters

- `folder` 'inbox' | 'starred' | 'sent' | 'drafts' | 'important' | 'scheduled' | 'all' | 'spam' | 'unauthenticated' | 'trash': Folder (view) to list.

## Response `200`

Threads of the folder.

- ThreadList
  - `folder` string, required
  - `threads` Thread[], required
    - `id` string, uuid, required
    - `subject` string
    - `createdAt` string, date-time

## Other responses

- `401`: Missing or invalid token.
- `403`: Insufficient scope.
- `404`: Resource not found.

---

[API](https://skmtc.dev/sending/apis/sending-dev-api.md) · [All operations](https://skmtc.dev/sending/apis/sending-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sending/apis/sending-dev-api/revisions/9fe78d2918a1?raw)