---
title: "List threads in an inbox"
method: GET
path: "/v1/inboxes/{inbox_id}/threads"
tags: ["Threads"]
---

# List threads in an inbox

`GET /v1/inboxes/{inbox_id}/threads`

## Request

- Base URL: `https://api.deadsimple.email`
- URL: `https://api.deadsimple.email/v1/inboxes/{inbox_id}/threads`
- Auth: HTTP bearer

## Path parameters

- `inbox_id` string, required

## Query parameters

- `limit` integer

## Headers

- `X-Workspace-Id` string, uuid

## Response `200`

Thread summaries with latest message

## Other responses

- `402`: Payment required. The request had no API key and this route can be paid per call. The x402 requirements are in the PAYMENT-REQUIRED header and repeated in the body; routes priced at or above $0.50 (inbox creation) also carry a Stripe MPP challenge in WWW-Authenticate. A rejected or mismatched payment gets this same response again with error.reason explaining why. Responses are Cache-Control no-store and expose the payment headers to browsers.

---

[API](https://skmtc.dev/deadsimple/apis/dead-simple-email-api.md) · [All operations](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/revisions/c697881be131?raw)