Get Conversation

Get a specific conversation by ID.

HTTP Request

GET https://dev.calry.app/api/v2/vrs/conversations/{conversationId}

Headers

Header	Value
Authorization	Bearer YOUR_ACCESS_TOKEN
workspaceId	YOUR_WORKSPACE_ID
integrationAccountId	YOUR_INTEGRATION_ACCOUNT_ID

Query Parameters

Parameter	Type	Description
realtime	bool	If true, the response will be streamed in real-time.

curl --location 'https://dev.calry.app/api/v2/vrs/conversations/5375328' \
--header 'Authorization: Bearer eyJraWQiOiJzLThkOTQwNzI5LWYxZmItNDFhMS1hMjIzLTg5ZWY3NmZjZDIyOCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjMwMDAvYXV0aCIsInVzZXJJZCI6IjY5YTYwNzVlLTViYTktNDA0NS05ZDZmLWY5YTJhZjAxOWVmNyIsIndvcmtzcGFjZUlkIjoiNGNjNTA5YjAtZDhmOC00YTU3LTlkNDgtNDQ0MThmYTUxNjBmIiwibmFtZSI6InRlc3QtdG9rZW4iLCJzb3VyY2UiOiJtaWNyb3NlcnZpY2UiLCJpYXQiOjE3MDIzMTQyMjAsImV4cCI6MTczODMxNDIyMH0.f0zNaSpDqFn4A8f2vUDdra11GxTv_9PhR7rdJprP5tVGw-qpp3m4LHCTtNFUSRg6gsrXm7XOHrNGZVOTOLmWl2f6S6TdMsACWvEV3lZp48bBGlluTWbPq2469sWAljF9bOlxpqDgbigHHb4bGNPqPOKh_xaSl-jJcBUMJqMnP7xdpEGjOW5dVDf7SxTlASA-GYoCiJy4AQ5F_7YtsL62Akl7l-BIjyrQZ6TtLBjUKkOiUpfVRDjgSaGWekiTL9t6cm0sZDhhoLXt3RM_lagjid9fEQLDk77zS6_ToJpaxqSQsNlZTd0lugM-wSQIrzwaaIR2KA_QyT5WiZPIO_VnQQ' \
--header 'workspaceId: 4cc509b0-d8f8-4a57-9d48-44418fa5160f' \
--header 'integrationAccountId: 36ccdccc-9314-4812-95be-7bfaa799ffbc'

Example Response

{
    "success": true,
    "data": {
        "id": "12345678",
        "externalThreadId": "87654321",
        "reservationId": [
            "11223344"
        ],
        "propertyId": [
            "55667788"
        ],
        "roomTypeId": [
            "312277"
        ],
        "recipient": {
            "name": "Alex Johnson",
            "email": null,
            "phone": "",
            "picture": "https://example.com/images/profile_placeholder.jpg"
        },
        "updatedAt": "2025-01-13T23:37:53",
        "messages": [
            {
                "id": "99887766",
                "body": "Thanks, you as well!",
                "senderType": "Guest",
                "createdAt": "2025-01-13T23:40:49",
                "updatedAt": "2025-01-13T23:40:49",
                "status": "SENT",
                "seenStatus": "UNSEEN",
                "attachments": [],
                "type": "CHANNEL",
                "isAutomatic": false,
                "subject": ""
            },
            {
                "id": "88776655",
                "body": "Ok great! We look forward to hosting you. Have wonderful 2025 :)",
                "senderType": "Owner",
                "createdAt": "2025-01-13T23:37:53",
                "updatedAt": "2025-01-13T23:37:55",
                "status": "SENT",
                "seenStatus": "SEEN",
                "attachments": [
                    {
                        "id": "12345",
                        "name": "booking-confirmation.jpeg",
                        "url": "https://example.com/attachments/booking-confirmation.jpeg",
                        "type": {
                            "mimeType": "image/jpeg"
                        }
                    }
                ],
                "type": "CHANNEL",
                "isAutomatic": false,
                "subject": ""
            },
            {
                "id": "77665544",
                "body": "Yes, it is for next year in 2026.",
                "senderType": "Guest",
                "createdAt": "2025-01-13T23:33:02",
                "updatedAt": "2025-01-13T23:33:02",
                "status": "SENT",
                "seenStatus": "UNSEEN",
                "attachments": [],
                "type": "CHANNEL",
                "isAutomatic": false,
                "subject": ""
            }
        ]
    }
}