---
title: "List email threads"
method: GET
path: "/api/v1/inbox/threads"
tags: ["Inbox"]
---

# List email threads

`GET /api/v1/inbox/threads`

## Request

- Base URL: `https://app.khotan.com`
- URL: `https://app.khotan.com/api/v1/inbox/threads`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Lists the workspace inbox's email threads, newest first. Filter by text in a sender or the subject. Set excludeInternal=true to leave out email that staff sent from the internal channel.

## Query parameters

- `limit` integer
- `pageToken` string
- `sender` string
- `subject` string
- `excludeInternal` 'true' | 'false'

## Response `200`

Email threads.

## Other responses

- `401`: Authentication is missing or invalid.
- `403`: The caller is not permitted to perform this action.
- `429`: Too many requests; retry after the indicated delay.

---

[API](https://skmtc.dev/khotan/apis/khotan-api.md) - [All operations](https://skmtc.dev/khotan/apis/khotan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/khotan/apis/khotan-api/revisions/90b512a53e42?raw)