---
title: "Get live_chat_message_details"
method: GET
path: "/live_chat_message_details"
tags: ["Live chat message details"]
---

# Get live_chat_message_details

`GET /live_chat_message_details`

## Request

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

Raw data for conversation messages understood as communicates exchanged by any actor in the livechat solution. Ticketing messages are not covered by this endpoint.

## Query parameters

- `_unique_id` string
- `visitor_id` string
- `thread_id` string
- `message_id` string
- `time_sent` string
- `channel` string
- `actor` string
- `internal_actor_id` string
- `message_content` string
- `conversation_link` string
- `visitor_message_sent_from_url` string
- `lyro_smart_action_id` string
- `lyro_smart_action_name` string
- `lyro_proactive_role_id` string
- `lyro_proactive_role_name` 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.
  - `visitor_id` string: Unique identifier for the visitor.
  - `thread_id` number: Unique identifier for the conversation thread.
  - `message_id` number: Unique identifier for the message.
  - `time_sent` string, date-time: Timestamp when the message was sent.
  - `channel` string: The communication channel through which the message was sent.
  - `actor` string: Determines the actor responsible for sending the message, including flows, Lyro AI agent, Lyro Simple/Smart Action, Lyro Proactive Role, agent and visitor.
  - `internal_actor_id` number: Identifier for the internal actor (agent or flow), null for Lyro and Lyro Smart Action messages.
  - `message_content` string: The content of the message sent.
  - `conversation_link` string: URL link to the conversation in the Tidio panel.
  - `visitor_message_sent_from_url` string: URL link to the page from which visitor sent the message. The URL may not always be available.
  - `lyro_smart_action_id` string: Identifier of Lyro Smart Action. Applies to messages where the actor is Lyro Smart Action. For internal Smart Action (lyro_smart_action_name = 'tidio_internal_create_a_ticket') ID is null.
  - `lyro_smart_action_name` string: Name of Lyro Smart Action. Applies to messages where the actor is Lyro Smart Action.
  - `lyro_proactive_role_id` string: Identifier of Lyro Proactive Role. Applies to messages where the actor is Lyro Proactive Role.
  - `lyro_proactive_role_name` string: Name of Lyro Proactive Role. Applies to messages where the actor is 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)