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

# List Threads

`GET /v1/threads`

Retrieves a list of threads from your Confident AI project.

## Query parameters

- `page` integer
- `pageSize` integer
- `environment` string
- `start` string, date-time
- `end` string, date-time
- `sortBy` 'createdAt' | 'lastActivity'
- `ascending` 'true' | 'false'

## Headers

- `CONFIDENT_API_KEY` string, required

## Response `200`

- ListThreadsResponse
  - `success` boolean, required — This is true if the threads were successfully retrieved.
  - `data` object, required — This maps to the list of threads retrieved.
    - `threads` ThreadSummary[], required — This is the list of threads retrieved.
      - `threadId` string, required — This is the thread ID you supplied when creating the thread.
      - `createdAt` string, date-time, required — This is when the thread was created.
      - `lastActivity` string, date-time, required — This is when the thread was last active.
      - `metadata` object — This is the custom metadata attached to the thread.
      - `tags` string[] — This is the list of tags associated with the thread.
      - `metricCollectionName` string — This is the name of the metric collection assigned to evaluate the thread.
      - `totalTraces` integer, required — This is the total number of traces in this thread.
    - `totalThreads` integer, required — This is the total number of threads retrieved.
  - `deprecated` boolean, required — This is true if this endpoint is deprecated.

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-03-03** `ecbd18488092` — 2 breaking, 2 info
  - removed the enum value `asc` from the `query` request parameter `ascending`
  - removed the enum value `desc` from the `query` request parameter `ascending`
  - added the new enum value `false` to the `query` request parameter `ascending`
  - added the new enum value `true` to the `query` request parameter `ascending`

[Change history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/threads/get.md)

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) · [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confident-ai/confident-ai-metrics-api/revisions/95cdde71b65e/schema)