---
title: "Get lyro_thread_details"
method: GET
path: "/lyro_thread_details"
tags: ["Lyro thread details"]
---

# Get lyro_thread_details

`GET /lyro_thread_details`

## Request

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

This endpoint provides you with raw data for threads handled by the Lyro AI Agent.

## Query parameters

- `_unique_id` string
- `thread_id` string
- `thread_started_at` string
- `thread_ended_at` string
- `conversation_id` string
- `visitor_id` string
- `first_message_intent` string
- `initial_message_channel` string
- `ind_thread_transferred_to_agent` string
- `thread_resolution` string
- `thread_first_message_id` string
- `thread_last_message_id` string
- `ind_thread_initiated_by_lyro_proactive_role` 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: Identifier of the project to which the thread belongs.
  - `thread_id` number: Unique identifier of the Lyro AI Agent thread.
  - `thread_started_at` string, date-time: Timestamp when the Lyro AI Agent thread started.
  - `thread_ended_at` string, date-time: Timestamp when the Lyro AI Agent thread ended.
  - `conversation_id` number: Identifier of the conversation associated with the Lyro AI Agent thread.
  - `visitor_id` string: Identifier of the visitor who participated in the conversation.
  - `first_message_intent` string: Intent of the first message in the thread.
  - `initial_message_channel` string: Determines the channel on which the first thread message was sent.
  - `ind_thread_transferred_to_agent` number: Indicator of whether the thread was transferred to a human agent.
  - `thread_resolution` string: Resolution status or outcome of the Lyro AI Agent thread (resolved/unresolved).
  - `thread_first_message_id` number: Identifier of the first message of Lyro AI Agent thread.
  - `thread_last_message_id` number: Identifier of the last message of Lyro AI Agent thread.
  - `ind_thread_initiated_by_lyro_proactive_role` number: Indicator of whether the thread was initiated by Lyro Proactive Role.
  - `_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)