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

# List threads

`GET /threads`

## Request

- Base URL: `https://api.korey.ai/api/v1`
- URL: `https://api.korey.ai/api/v1/threads`
- Auth: HTTP bearer

Lists visible threads for the authenticated user. Pass `last_id` as `?after=` to paginate.

## Query parameters

- `owned` boolean
- `private` boolean
- `archived` boolean
- `q` string
- `sort_by` 'updated_at' | 'created_at'
- `sort_dir` 'asc' | 'desc'
- `updated_since` string
- `limit` integer
- `after` string

## Response `200`

Success

- object
  - `data` object[], required: Array of thread objects.
    - `id` string, required: Unique thread ID.
    - `name` string, nullable, required: Optional display name for the thread.
    - `state` 'ready' | 'waiting' | 'active' | 'error' | 'interrupted', required: Current processing state of the thread.
    - `is_private` boolean, required: When true the thread is only visible to its owner.
    - `archived` boolean, required: Whether the thread has been archived.
    - `owner` object, required: The user who created the thread.
      - `id` string, required: Owner user ID.
      - `name` string, nullable, required: Owner display name.
    - `created_at` string, required: ISO 8601 timestamp when the thread was created.
    - `updated_at` string, required: ISO 8601 timestamp when the thread was last updated.
    - `app_url` string, required: Direct link to this thread in the Korey web app.
  - `first_id` string, nullable, required: ID of the first item in the page. null when the page is empty.
  - `last_id` string, nullable, required: ID of the last item in the page. Pass as ?after= to fetch the next page.
  - `has_more` boolean, required: True when there are more results beyond this page.
  - `limit` integer, required: The limit applied to this request.

## Other responses

- `401`: Unauthorized — Bearer token required or invalid
- `403`: Forbidden — token does not have required scope

---

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