SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Outreach

Read one conversation and its messages

Returns up to 200 messages, oldest first.

GEThttps://app.softsolz.uk/api/v1/services/outreach/inbox/conversations/{id}

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Response

Response Body

conversationobjectThe conversation.
messagesarray of objectsMessages, oldest first.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/outreach/inbox/conversations/{id} \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"conversation": {
"id": "311",
"tenant_id": "4c1a7e52-9b3d-4f86-a2e1-7d5c0b9f3e61",
"customer_id": null,
"phone": "+447700900123",
"email": null,
"contact_id": null,
"channel": "sms",
"status": "open",
"assigned_to": null,
"assignee_name": null,
"display_name": "Jane Doe",
"last_inbound_at": "2026-10-01T08:30:00.000Z",
"last_outbound_at": null,
"last_message_at": null,
"last_message_preview": "Is the offer still on?",
"unread_count": 1,
"auto_reply_enabled": true,
"labels": [
"vip"
],
"ai_summary": null,
"ai_intent": null,
"ai_summarised_at": null,
"reply_window_expires_at": null,
"reply_window_open": true,
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
},
"messages": [
{
"id": "9001",
"direction": "inbound",
"channel": "sms",
"subject": null,
"body": "Is the offer still on?",
"status": "received",
"provider": "twilio",
"provider_ref": "SM5f1b...",
"error": null,
"delivered_at": null,
"read_at": null,
"matched_keyword": null,
"initiated_by_user_id": null,
"sender_name": null,
"reminder_id": null,
"campaign_id": null,
"duration_seconds": null,
"outcome": null,
"source": "customer",
"created_at": "2026-09-01T09:00:00.000Z"
}
]
}
}