---
title: "Get Thread"
method: GET
path: "/threads/{thread_id}"
tags: ["Threads"]
---

# Get Thread

`GET /threads/{thread_id}`

## Request

- Base URL: `https://api.puppeteerai.com`
- URL: `https://api.puppeteerai.com/threads/{thread_id}`
- Auth: none declared. Required headers: `Authorization`

Get thread details and usage statistics.

## Path parameters

- `thread_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- GetThreadResponse
  - `id` string, required: The unique identifier for the thread.
  - `alias` string, nullable: An optional alias for the thread.
  - `timezone` string, nullable: Timezone of the thread.
  - `usage` ThreadUsage, required
    - `billable_messages` integer, required: Number of billable messages in the thread.
    - `billable_message_cost` number, required: Total cost of billable messages.
    - `voice_minutes` number, required: Total voice call duration in minutes.
    - `voice_cost` number, required: Total cost of voice calls.
    - `total_cost` number, required: Combined cost of messages and voice calls.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api.md) - [All operations](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api/revisions/94b4e928b42f?raw)