---
title: "List threads"
method: GET
path: "/v1/threads"
tags: ["v1"]
---

# List threads

`GET /v1/threads`

List all threads for the authenticated project. Supports cursor-based pagination and filtering by user key.

## Query parameters

- `limit` number
- `cursor` string
- `userKey` string

## Response `200`

List of threads

- ListThreadsResponse
  - `threads` V1Thread[], required — List of threads
    - `id` string, required — Unique identifier for this thread
    - `name` string — Thread name (auto-generated or user-set)
    - `userKey` string — Optional user key for thread organization
    - `runStatus` 'idle' | 'waiting' | 'streaming', required — Current run status: idle (no run), waiting (run started, awaiting content), streaming (receiving content)
    - `currentRunId` string — ID of the currently active run (when not idle)
    - `statusMessage` string — Human-readable status message (e.g., 'Fetching weather data...')
    - `lastRunCancelled` boolean — Whether the last run was cancelled
    - `lastRunError` RunError
      - `code` string — Error code
      - `message` string, required — Error message
    - `pendingToolCallIds` string[] — Tool call IDs awaiting client-side results. If non-empty, next run must provide tool_result content with previousRunId set.
    - `lastCompletedRunId` string — ID of the last completed run. Required as previousRunId when continuing after tool calls.
    - `metadata` object — Additional metadata
    - `createdAt` string, required — When the thread was created (ISO 8601)
    - `updatedAt` string, required — When the thread was last updated (ISO 8601)
  - `nextCursor` string — Cursor for the next page of results
  - `hasMore` boolean, required — Whether there are more results

---

[API](https://skmtc.net/tambo-ai/apis/tambo-api.md) · [All operations](https://skmtc.net/tambo-ai/apis/tambo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tambo-ai/tambo-api/revisions/312691b28f1c/schema)