curl https://api.open.cx/connect/threads/order_84421 \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "th_9f2c4e",
"reference": "order_84421",
"status": "wrap_up",
"order_status": "delivered",
"participants": [
{ "id": "prt_c81", "role": "customer", "display_name": "Fatima", "language": "ar" },
{ "id": "prt_m32", "role": "merchant", "display_name": "Shawarma House", "language": "en" },
{ "id": "prt_d55", "role": "courier", "display_name": "Aleksei", "language": "en" }
],
"lanes": [
{ "id": "customer_merchant", "status": "active", "supervisor_mode": "resolve" },
{ "id": "customer_courier", "status": "active", "supervisor_mode": "resolve" }
],
"message_counts": { "customer_merchant": 6, "customer_courier": 4, "supervisor": 3 },
"escalations": [],
"created_at": "2026-07-30T14:03:11Z"
}
Connect
Get a Connect thread
Fetch one thread by ID or by your order reference — participants, lanes, lifecycle status, Supervisor config, and custom data in a single read.
GET
/
connect
/
threads
/
{thread_id}
curl https://api.open.cx/connect/threads/order_84421 \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "th_9f2c4e",
"reference": "order_84421",
"status": "wrap_up",
"order_status": "delivered",
"participants": [
{ "id": "prt_c81", "role": "customer", "display_name": "Fatima", "language": "ar" },
{ "id": "prt_m32", "role": "merchant", "display_name": "Shawarma House", "language": "en" },
{ "id": "prt_d55", "role": "courier", "display_name": "Aleksei", "language": "en" }
],
"lanes": [
{ "id": "customer_merchant", "status": "active", "supervisor_mode": "resolve" },
{ "id": "customer_courier", "status": "active", "supervisor_mode": "resolve" }
],
"message_counts": { "customer_merchant": 6, "customer_courier": 4, "supervisor": 3 },
"escalations": [],
"created_at": "2026-07-30T14:03:11Z"
}
Fetch a single thread. Accepts either the thread ID (
th_…) or your order reference — GET /connect/threads/order_84421 resolves the same thread, so you never store our IDs if you don’t want to.
Path
string
required
Thread ID (
th_…) or your reference (order ID).Response
The full thread object — same shape as Create thread, plus live lane state and counters.object
Per-lane message totals, including
supervisor messages — a quick deflection read without listing messages.array
Sessions this thread escalated into:
{ session_id, reason, created_at }.curl https://api.open.cx/connect/threads/order_84421 \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "th_9f2c4e",
"reference": "order_84421",
"status": "wrap_up",
"order_status": "delivered",
"participants": [
{ "id": "prt_c81", "role": "customer", "display_name": "Fatima", "language": "ar" },
{ "id": "prt_m32", "role": "merchant", "display_name": "Shawarma House", "language": "en" },
{ "id": "prt_d55", "role": "courier", "display_name": "Aleksei", "language": "en" }
],
"lanes": [
{ "id": "customer_merchant", "status": "active", "supervisor_mode": "resolve" },
{ "id": "customer_courier", "status": "active", "supervisor_mode": "resolve" }
],
"message_counts": { "customer_merchant": 6, "customer_courier": 4, "supervisor": 3 },
"escalations": [],
"created_at": "2026-07-30T14:03:11Z"
}
Was this page helpful?