Get Conversation

GET

/v2/conversations/service-account/conversationId

Returns a single conversation's full summary — same shape as each item in the List Conversations response, just fetched directly by ID instead of by channel/filter.

conversationId is supplied directly in the URL path.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Responses

🟢200OK

application/json

Returns the conversation.

Bodyapplication/json

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v2/conversations/service-account/conversationId' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "id": "3a21fc...............",
    "sentiment": 1,
    "status": 1,
    "lastActivityAt": "2026-06-21T13:15:47.459339",
    "contactId": "3a21fb...............",
    "contactName": "Ahmed Noshy | Hatif Co",
    "contactType": 1,
    "phoneNumber": "+966501234567",
    "channelId": "3a1bf3...............",
    "assigneeId": null,
    "assignedAiAgentId": null,
    "isAiAssignee": false,
    "assigneeName": null,
    "channel": {
        "id": "3a1bf3...............",
        "name": "هاتف",
        "type": 3,
        "icon": "📱",
        "phoneNumber": null
    },
    "lastEventSourceType": null,
    "lastEventDirection": null,
    "lastEventStatus": "",
    "lastEventPreviewBody": null,
    "lastEventOccurredAt": null,
    "lastEventsCount": 0,
    "tags": [],
    "unreadCount": 0,
    "isPinned": false
}

Modified at 2026-06-22 15:42:24

Assign Conversation

Create Outbound IVR