---
title: "Query Threads"
method: POST
path: "/v2/threads/query"
tags: ["threads"]
---

# Query Threads

`POST /v2/threads/query`

Query threads within a project (session), with cursor-based pagination.
Returns threads matching the given time range and optional filter,
backed by the smithdb QueryThreads gRPC RPC.

## Request body

- ThreadsQueryThreadsRequestBody
  - `cursor` string
  - `filter` string
  - `limit` integer
  - `max_start_time` string
  - `min_start_time` string
  - `session_id` string

## Response `200`

threads and cursors

- object

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/7bbcecd856b2/schema)