---
title: "List threads for an assistant"
method: GET
path: "/v1/threads"
---

# List threads for an assistant

`GET /v1/threads`

## Request

- Base URL: `https://api.runbear.io`
- URL: `https://api.runbear.io/v1/threads`
- Auth: HTTP bearer

Retrieve a list of conversation threads for the specified assistant, ordered by creation date (most recent first)

## Query parameters

- `assistant_id` string, uuid, required: Unique identifier of the assistant
- `limit` integer: Maximum number of threads to return in this page (1–100). Defaults to 100.
- `cursor` string: Opaque pagination cursor. Pass the `nextCursor` from a previous response to fetch the next page of threads (ordered most-recent first). Omit on the first request.

## Response `200`

Default Response

- object
  - `threads` ThreadDetails[], required
    - `id` string, uuid, required: Unique identifier of the thread
    - `createdAt` string, required: Timestamp when the thread was created
    - `title` string, nullable, required: Optional title of the thread
  - `nextCursor` string, nullable, required: Opaque cursor for the next page, or null when there are no more threads. Pass it back as the `cursor` query parameter to retrieve the next page.

## Other responses

- `404`: `assistant_id` does not name an agent in your organization.

---

[API](https://skmtc.dev/runbear/apis/runbear-api.md) - [All operations](https://skmtc.dev/runbear/apis/runbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runbear/apis/runbear-api/revisions/c6a9c3066a5a?raw)