> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drin.run/llms.txt
> Use this file to discover all available pages before exploring further.

# List threads

> GET /v1/threads — page through conversation threads, optionally scoped to a single inbox.

Page through conversation threads, newest activity first. A thread joins inbound and outbound messages between an inbox and a correspondent.

**`GET /v1/threads`**

Threads are the conversation view over receiving. Each row summarizes a conversation; fetch one with [retrieve](/api-reference/threads/get) to read every message in it. Pass `inboxId` to scope the feed to a single receive address.

## Query parameters

<ParamField query="inboxId" type="string">
  Narrow the feed to a single inbox. Omit to list threads across every inbox in the project.
</ParamField>

<ParamField query="limit" type="integer">
  Page size, 1–100. Defaults to 25.
</ParamField>

<ParamField query="cursor" type="string">
  The `nextCursor` from a previous response. Omit for the first page.
</ParamField>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.drin.run/v1/threads?inboxId=inb_01HZ9C7R2K&limit=25" \
    -H "Authorization: Bearer $DRIN_API_KEY"
  ```

  ```typescript Node.js theme={null}
  import { DrinClient } from "@drin00/sdk";

  const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

  const { data, nextCursor } = await drin.threads.list({
    inboxId: "inb_01HZ9C7R2K",
  });

  for (const thread of data) {
    console.log(thread.id, thread.subject, thread.lastMessageAt);
  }
  ```
</CodeGroup>

## Response

`200 OK` — a cursor page of thread summaries, ordered by `lastMessageAt`. See [Pagination](/api-reference/pagination) for the full walk.

```json theme={null}
{
  "data": [
    {
      "id": "thr_01HZ9D8S3M",
      "senderId": "snd_01HZ0A1B2C",
      "inboxId": "inb_01HZ9C7R2K",
      "subject": "Re: Where's my order?",
      "threadKey": "support@acme.com|jordan@example.com",
      "lastMessageAt": "2026-06-02T10:41:00Z",
      "createdAt": "2026-06-02T09:58:00Z"
    }
  ],
  "nextCursor": null
}
```