List threads

GEThttps://anjal.app/v1/inboxes/{id}/threads

Newest first, each with its labels. ?labels=a,b returns threads that carry every label across their messages. Spam is left out unless includeSpam=true; a thread containing spam then carries hasSpam: true.

Path parameters

id

required

string

Inbox UUID

Query parameters

`limit` integer
`offset` integer
`labels` string	Comma-separated labels, e.g. `needs-review,billing`. Only results carrying every one are returned.
`includeSpam` boolean	Spam is stored but left out by default. Pass `true` to include it (`include_spam` also works).

Responses

200application/jsonOK

`threads` object[]
`threadId` string	format: uuid
`subject` string
`messageCount` integer
`firstMessageAt` string	format: date-time
`lastMessageAt` string	format: date-time
`labels` string[]	Every label carried by any message in the thread.
`hasSpam` boolean	Present (true) only when the thread contains spam, which happens with `includeSpam=true`.

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { Anjal } from "anjal";

const client = new Anjal({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/inboxes/{id}/threads
const result = await client.request("get", "/v1/inboxes/{id}/threads", { params: { id: "00000000-0000-0000-0000-000000000000" } });

Example response · 200

{
  "threads": [
    {
      "threadId": "00000000-0000-0000-0000-000000000000",
      "subject": "string",
      "messageCount": 0,
      "firstMessageAt": "2026-11-03T09:51:51.901Z",
      "lastMessageAt": "2026-11-03T09:51:51.901Z",
      "labels": [
        "string"
      ],
      "hasSpam": false
    }
  ]
}