Docs
DashboardGet API key
API · threads

List threads

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 to read every message in it. Pass inboxId to scope the feed to a single receive address.

01 Query parameters

inboxIdstringOptional
Narrow the feed to a single inbox. Omit to list threads across every inbox in the project.
limitintegerOptional
Page size, 1–100. Defaults to 25.
cursorstringOptional
The nextCursor from a previous response. Omit for the first page.

02 Request

curl "https://api.drin.run/v1/threads?inboxId=inb_01HZ9C7R2K&limit=25" \
  -H "Authorization: Bearer $DRIN_API_KEY"

03 Response

200 OK — a cursor page of thread summaries, ordered by lastMessageAt. See Pagination for the full walk.

JSON
{
  "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
}