Get Conversation Timeline

GET

/v2/conversations/service-account/{conversationId}/timeline

Returns a paged list of timeline events for a conversation.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://your-auth-server/connect/token

Scopes:

VoxaAPI-Access Voxa API as a service account

Path Params

Query Params

Responses

🟢200

application/json

Paged list of conversation timeline events

Bodyapplication/json

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v2/conversations/service-account//timeline?Sorting=undefined&SkipCount=undefined&MaxResultCount=undefined'

Response Example

{
    "TotalCount": 1,
    "Items": [
        {
            "EventId": "a1b2c3d4-5678-9abc-def0-123456789abc",
            "ConversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "ContactId": "8a2e0b4c-1234-5678-9abc-def012345678",
            "ChannelId": "b1c2d3e4-5678-9abc-def0-123456789abc",
            "SourceType": 1,
            "SourceId": "c2d3e4f5-6789-abcd-ef01-23456789abcd",
            "Direction": 1,
            "CreationTime": "2026-03-17T12:00:00Z",
            "Status": "Answered",
            "ErrorCode": null,
            "FailureReason": null,
            "IsAi": false,
            "Attachment": null,
            "OwnerUserId": null,
            "AiAgentId": null,
            "DurationOrSize": "00:02:30",
            "RingingDuration": "00:00:15",
            "Body": null,
            "HandlerName": "Agent Smith",
            "AiSummary": null,
            "ReplyTo": null,
            "InternalThread": null,
            "Location": null,
            "Assignation": null
        }
    ]
}

Modified at 2026-03-18 00:05:34

Get Workspace Users

List Conversations