Get SMS Conversation By ID

GET

https://platform-api.convirza.com/v3/conversations/sms/{id}

SMS

Last modified:2026-07-24 13:10:44

Returns a single SMS conversation by its ID including all messages.

Authorization
Results are automatically filtered to the org units accessible to the authenticated user. If the conversation does not exist or belongs to a different organization, a 404 is returned.

Response includes:

Conversation metadata (status, timestamps, assigned agent)

All messages in chronological order (oldest first)

Organization unit details

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

SMS conversation returned successfully

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://platform-api.convirza.com/v3/conversations/sms/{id}' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "conversation_id": 2710,
        "phone_number": "2244455263",
        "source": "3853082169",
        "source_name": "",
        "conversation_started": "2026-02-19T06:38:02.000Z",
        "conversation_updated": "2026-02-19T06:46:01.000Z",
        "conversation_status": "read",
        "ct_user_id": 3319,
        "agent": "Akshay Bhone",
        "pin": false,
        "unread_count": 0,
        "org_unit_id": 71932,
        "org_unit_name": "MJ - Test Group",
        "messages": [
            {
                "message_id": 10100,
                "direction": "outgoing",
                "message_text": "New test",
                "created_at": "2026-02-19T06:38:02.000Z",
                "status": null
            }
        ]
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-07-24 13:10:44

Get SMS Conversations

Get Conversations By Custom Insights