Get conversation by ID

Retrieve a single conversation record with transcript messages

GET /organizations/{organization_id}/projects/{project_id}/conversations/{conversation_id}

cURL

curl -X GET "https://backend.botcadence.com/organizations/ORG_ID/projects/PROJECT_ID/conversations/CONV_ID" \
  -H "X-API-Key: bot_live_YOUR_KEY"

const response = await fetch(
  `https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/conversations/${conversationId}`,
  { headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);

import os
import requests

response = requests.get(
    f"https://backend.botcadence.com/organizations/{organization_id}/projects/{project_id}/conversations/{conversation_id}",
    headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
)

200

{
  "status": "success",
  "message": "Conversation history retrieved successfully",
  "data": {
    "_id": "665f1a2b3c4d5e6f7a8b9c0d",
    "status": "completed",
    "conversation_type": "outbound",
    "phone_number": "[phone]",
    "start_time": "2026-07-21T15:04:00Z",
    "end_time": "2026-07-21T15:06:22Z",
    "duration_seconds": 142,
    "messages": [
      {
        "role": "assistant",
        "content": "Hi Alex, thanks for taking my call."
      }
    ]
  },
  "status_code": 200
}

{
  "status": "error",
  "message": "Conversation history not found",
  "data": null,
  "status_code": 404
}

Returns one conversation by ID, including transcript messages.

Authentication

X-API-Key · string · required

Project API key for this organization and project. Format: bot_live_…

Path parameters

organization_id · string · required

Organization ID. Must match the API key.

project_id · string · required

Project ID. Must match the API key.

conversation_id · string · required

Conversation ID.

Response

Returns the conversation document plus a messages array.

_id · string · required

Conversation ID.

status · string · required

Conversation status (for example completed, live, failed).

conversation_type · string

outbound, inbound, chat, or webvoice.

phone_number · string

Caller / callee phone number when applicable.

start_time · datetime

Conversation start time.

duration_seconds · number

Call duration in seconds.

messages · array · required

Transcript messages for the conversation.

Errors

401 · Unauthorized

Missing, invalid, or revoked API key.

403 · Forbidden

API key is not authorized for this organization or project.

404 · Not Found

Conversation history not found.

cURL

curl -X GET "https://backend.botcadence.com/organizations/ORG_ID/projects/PROJECT_ID/conversations/CONV_ID" \
  -H "X-API-Key: bot_live_YOUR_KEY"

const response = await fetch(
  `https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/conversations/${conversationId}`,
  { headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);

import os
import requests

response = requests.get(
    f"https://backend.botcadence.com/organizations/{organization_id}/projects/{project_id}/conversations/{conversation_id}",
    headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
)

200

{
  "status": "success",
  "message": "Conversation history retrieved successfully",
  "data": {
    "_id": "665f1a2b3c4d5e6f7a8b9c0d",
    "status": "completed",
    "conversation_type": "outbound",
    "phone_number": "[phone]",
    "start_time": "2026-07-21T15:04:00Z",
    "end_time": "2026-07-21T15:06:22Z",
    "duration_seconds": 142,
    "messages": [
      {
        "role": "assistant",
        "content": "Hi Alex, thanks for taking my call."
      }
    ]
  },
  "status_code": 200
}

{
  "status": "error",
  "message": "Conversation history not found",
  "data": null,
  "status_code": 404
}