Get Conversation Timeline

GET

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

Returns the full chronological timeline of everything that happened in a conversation — calls, WhatsApp messages, and agent re-assignments — merged into one ordered, paginated feed.

contentFilter narrows which event types are returned: 1=All (default if omitted), 2=Media, 3=VoiceNotes, 4=Documents, 5=Calls.

Key fields:

sourceType/sourceId — tell you what underlying entity (Call / WhatsApp message / conversation-event assignment) this row came from.

ownerUserId/aiAgentId/handlerName — tell you who or what handled it.

durationOrSize/ringingDuration — call-specific.

location/contacts/aiSummary/internalThread — only populated when relevant to that row's type. Most fields are null on any given row — that's expected, not missing data.

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://api.voxa.sa/connect/token

Scopes:

VoxaAPI-Access Voxa API as a service account

Query Params

Responses

🟢200OK

application/json

Paged list of conversation timeline events.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://api.voxa.sa/v2/conversations/service-account/{{conversationId}}/timeline?contentFilter=undefined&skipCount=0&maxResultCount=50&sorting=undefined'

Response Example

{
    "totalCount": 47,
    "items": [
        {
            "participants": null,
            "eventId": "3a21fd...............",
            "conversationId": "3a1f17...............",
            "contactId": "3a1e15...............",
            "channelId": "3a1da0...............",
            "sourceType": 2,
            "sourceId": "3a21fd...............",
            "direction": 2,
            "creationTime": "2026-06-21T19:03:01.968328",
            "status": "Sent",
            "errorCode": null,
            "failureReason": null,
            "isAi": false,
            "attachment": "https://voxa.oss-me-central-1.aliyuncs.com/app/6d156d37-6eb1-4694-bb74-193012c0b0ed/voxa_api_report-%281%29.pdf",
            "mimeType": null,
            "playbackAttachment": null,
            "playbackMimeType": null,
            "ownerUserId": "3a1dc2...............",
            "aiAgentId": null,
            "durationOrSize": null,
            "ringingDuration": null,
            "body": "hala",
            "handlerName": "نصحي",
            "aiSummary": null,
            "replyTo": null,
            "internalThread": null,
            "location": null,
            "contacts": null,
            "assignation": null,
            "reactions": [],
            "csatRating": null,
            "imageGroupId": null
        },
        {
            "participants": null,
            "eventId": "3a21fd...............",
            "conversationId": "3a1f17...............",
            "contactId": "3a1e15...............",
            "channelId": "3a1da0...............",
            "sourceType": 2,
            "sourceId": "3a21fd...............",
            "direction": 2,
            "creationTime": "2026-06-21T18:57:37.965947",
            "status": "Sent",
            "errorCode": null,
            "failureReason": null,
            "isAi": true,
            "attachment": "https://hebbkx1anhila5yf.public.blob.vercel-storage.com/Gen-AI-aSDQ2BA4lj9Su0juAaJjTRFjaJZNVo.jpg",
            "mimeType": null,
            "playbackAttachment": null,
            "playbackMimeType": null,
            "ownerUserId": null,
            "aiAgentId": null,
            "durationOrSize": null,
            "ringingDuration": null,
            "body": "Test caption",
            "handlerName": "",
            "aiSummary": null,
            "replyTo": null,
            "internalThread": null,
            "location": null,
            "contacts": null,
            "assignation": null,
            "reactions": [],
            "csatRating": null,
            "imageGroupId": null
        }
    ]
}

Modified at 2026-06-22 13:55:53

Get Workspace Users

List Conversations