> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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

<ParamField path="thread_id" type="string" required>
  Thread ID (`th_…`) or your `reference` (order ID).
</ParamField>

## Response

The full thread object — same shape as [Create thread](/api-reference/connect/create-thread), plus live lane state and counters.

<ResponseField name="message_counts" type="object">
  Per-lane message totals, including `supervisor` messages — a quick deflection read without listing messages.
</ResponseField>

<ResponseField name="escalations" type="array">
  Sessions this thread escalated into: `{ session_id, reason, created_at }`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl https://api.open.cx/connect/threads/order_84421 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"dark"}
  {
    "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"
  }
  ```
</ResponseExample>