Get customer chat conversations

List chat threads for a customer profile

GET /organizations/{organization_id}/projects/{project_id}/customer-profiles/{customer_profile_id}/chat-conversations

cURL

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

const response = await fetch(
  `https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/customer-profiles/${profileId}/chat-conversations`,
  { 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}/customer-profiles/{customer_profile_id}/chat-conversations",
    headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
)

200

{
  "status": "success",
  "message": "Chat conversations retrieved successfully",
  "data": {
    "threads": [
      {
        "_id": "665f1a2b3c4d5e6f7a8b9c0d",
        "channel_type": "web",
        "last_message": "Thanks for the help!",
        "updated_at": "2026-07-21T15:04:00Z"
      }
    ]
  },
  "status_code": 200
}

Returns chat conversation threads for one customer profile (inbox / thread picker data).

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.

customer_profile_id · string · required

Customer profile ID.

Response

threads · array · required

Chat thread summaries for the customer profile.

Errors

401 · Unauthorized

Missing, invalid, or revoked API key.

403 · Forbidden

API key is not authorized for this organization or project.

404 · Not Found

Customer profile not found in this project.

cURL

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

const response = await fetch(
  `https://backend.botcadence.com/organizations/${organizationId}/projects/${projectId}/customer-profiles/${profileId}/chat-conversations`,
  { 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}/customer-profiles/{customer_profile_id}/chat-conversations",
    headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
)

200

{
  "status": "success",
  "message": "Chat conversations retrieved successfully",
  "data": {
    "threads": [
      {
        "_id": "665f1a2b3c4d5e6f7a8b9c0d",
        "channel_type": "web",
        "last_message": "Thanks for the help!",
        "updated_at": "2026-07-21T15:04:00Z"
      }
    ]
  },
  "status_code": 200
}