Texa Desk Application API · Conversations

Conversation Reporting Events

GET/api/v1/accounts/{account_id}/conversations/{conversation_id}/reporting_events

Get reporting events for a specific conversation. This endpoint returns events such as first response time, resolution time, and other metrics for the conversation, sorted by creation time in ascending order.

Authorization

api_access_tokenheaderrequired

A person's access token (Texa Desk, Profile settings → Access token) or an agent bot's token, in the api_access_token header. It acts as that person, with their role's permissions.

Path parameters

account_idintegerrequired

The numeric ID of the account

conversation_idintegerrequired

The numeric ID of the conversation

Responses

200

Success

idnumber

ID of the reporting event

namestring

Name of the event (e.g., first_response, resolution, reply_time)

valuenumber

Value of the metric in seconds

value_in_business_hoursnumber

Value of the metric in seconds, calculated only for business hours

event_start_timestring (date-time)

The timestamp when the event started

event_end_timestring (date-time)

The timestamp when the event ended

account_idnumber

ID of the account

conversation_idnumber

ID of the conversation

inbox_idnumber

ID of the inbox

user_idnumber

ID of the user/agent

created_atstring (date-time)

The timestamp when the reporting event was created

updated_atstring (date-time)

The timestamp when the reporting event was last updated

403

Access denied

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

404

Conversation not found

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} r = requests.get("https://desk.texadesk.com/api/v1/accounts/1/conversations/1/reporting_events", headers=headers) r.raise_for_status() print(r.json())

[ { "id": 1.0, "name": "string", "value": 1.0, "value_in_business_hours": 1.0, "event_start_time": "2026-10-19T10:00:00Z", "event_end_time": "2026-10-19T10:00:00Z", "account_id": 1.0, "conversation_id": 1.0, "inbox_id": 1.0, "user_id": 1.0, "created_at": "2026-10-19T10:00:00Z", "updated_at": "2026-10-19T10:00:00Z" } ]