---
title: "Get agent_thread_details"
method: GET
path: "/agent_thread_details"
tags: ["Agent thread details"]
---

# Get agent_thread_details

`GET /agent_thread_details`

## Request

- Base URL: `https://taa.data.tidio.com`
- URL: `https://taa.data.tidio.com/agent_thread_details`
- Auth: API key in header `X-Tidio-Openapi-Client-Id` and API key in header `X-Tidio-Openapi-Client-Secret`

Raw data regarding human agent threads. Lyro AI agent threads are not covered in this endpoint.

## Query parameters

- `_unique_id` string
- `thread_id` string
- `thread_started_at` string
- `thread_ended_at` string
- `conversation_id` string
- `visitor_id` string
- `thread_first_message_id` string
- `thread_last_message_id` string
- `ind_missed_thread` string
- `ind_agent_thread_taken_over_by_flow` string
- `thread_first_response_time_seconds` string
- `thread_duration_seconds` string
- `thread_first_response_agent_id` string
- `thread_intent` string
- `initial_message_actor` string
- `initial_message_channel` string
- `_updated_at` string
- `select` string
- `order` string
- `offset` string
- `limit` string, required

## Headers

- `Range` string
- `Range-Unit` string
- `Prefer` 'count=none'

## Response `200`

OK

- object[]
  - `_unique_id` number: Technical field used as primary key of the model.
  - `project_id` number: Unique identifier for the project.
  - `thread_id` number: Unique identifier for the conversation thread.
  - `thread_started_at` string, date-time: Timestamp indicating when the thread started.
  - `thread_ended_at` string, date-time: Timestamp indicating when the thread ended.
  - `conversation_id` number: Unique identifier for the conversation.
  - `visitor_id` string: Unique identifier for the visitor.
  - `thread_first_message_id` number: Identifier of the first message of agent thread.
  - `thread_last_message_id` number: Identifier of the last message of agent thread.
  - `ind_missed_thread` number: Indicator of whether the thread was missed by agents (not replied to).
  - `ind_agent_thread_taken_over_by_flow` number: Indicator of threads that were initially available to be picked up by agents but didn't receive any response and were eventually taken over by a Flow. As such, they disappeared from the Unassigned section.
  - `thread_first_response_time_seconds` number: The time (in seconds) taken for the first agent response in the thread.
  - `thread_duration_seconds` number: The time (in seconds) from first to last message. Is calculated only when a thread contains both agent and visitor messages.
  - `thread_first_response_agent_id` number: The identifier of the agent who made the first response in the thread.
  - `thread_intent` string: The identified intent of the conversation thread.
  - `initial_message_actor` string: Determines the actor responsible for sending the first message, including flows, Lyro AI agent, Lyro Task, agent and visitor.
  - `initial_message_channel` string: Determines the channel of the first message.
  - `_updated_at` string, date-time: Technical timestamp (UTC, NTZ)

## Other responses

- `206`: Partial Content
- `408`: Request Timeout. The query took longer than the database's 25s statement limit -- almost always an unbounded read of a large table. Add a `limit`, narrow the date filter, or page with `Range`/keyset instead of scanning the whole table. `Prefer: count=exact` also forces a full scan; use `count=planned` on the large tables.

---

[API](https://skmtc.dev/tidio/apis/tidio-analytics-api.md) - [All operations](https://skmtc.dev/tidio/apis/tidio-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tidio/apis/tidio-analytics-api/revisions/960021ed741c?raw)