---
title: "Get trace thread"
method: GET
path: "/v2/sessions/{session_id}"
tags: ["Threads"]
---

# Get trace thread

`GET /v2/sessions/{session_id}`

Get a trace thread.

## Path parameters

- `session_id` string, required

## Response `200`

OK

- Thread
  - `_id` string, required — Internal thread record ID.
  - `external_id` string, required — Client-provided thread identifier used to group related traces.
  - `duration` number, double, required — Total thread duration in milliseconds.
  - `contact_ids` string[], required — Contact IDs associated with the thread.
  - `billing` ThreadBilling, required
    - `input_cost` number, double, required
    - `output_cost` number, double, required
    - `total_cost` number, double, required
  - `usage` ThreadUsage, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required
  - `traces_count` integer, required — Number of traces associated with the thread.
  - `tags` string[], required — Tags used to categorize the thread.
  - `project_id` string
  - `started_at` string, date-time
  - `updated_at` string, date-time
  - `title` string — Display title. Does not replace external_id and is not used to group traces.
  - `client` string — Originating coding assistant or client, such as claude-code, cursor, or codex.
  - `repo` string — Canonical git repository for a coding-agent thread, such as github.com/org/repo.
  - `kind` 'THREAD_KIND_UNSPECIFIED' | 'THREAD_KIND_CONVERSATION' | 'THREAD_KIND_CODING_AGENT'

## Changes

> 350 revisions in range; 136 not diffed.

- **2026-09-07** `bcd6172f8655` — 1 info
  - endpoint added
- **2026-09-07** `dcc0afb98a48` — 1 breaking
  - api path removed without deprecation
- **2026-09-06** `e1a2869bc12f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/sessions/:session_id/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/3c7d859558ee?raw)