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

# List Connect threads

> Page through threads filtered by status, order status, participant, or date range. Use for ops dashboards, dispute lookups, and archive queries.

List threads for your organization, newest first, cursor-paginated.

## Query

<ParamField query="status" type="string">
  Filter by lifecycle status: `open`, `wrap_up`, `locked`, `archived`.
</ParamField>

<ParamField query="order_status" type="string">
  Filter by the order status you last reported (`confirmed`, `picked_up`, `delivered`…).
</ParamField>

<ParamField query="participant_external_id" type="string">
  Threads that include this participant — every conversation a given courier or merchant has been part of.
</ParamField>

<ParamField query="escalated" type="boolean">
  Only threads that escalated into a support session.
</ParamField>

<ParamField query="created_after" type="string">
  ISO 8601 lower bound on creation time.
</ParamField>

<ParamField query="cursor" type="string">
  Cursor from a previous response.
</ParamField>

<ParamField query="limit" type="number" default="25">
  Page size, max 100.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Thread objects (same shape as [Get thread](/api-reference/connect/get-thread)).
</ResponseField>

<ResponseField name="next_cursor" type="string">
  Present when more results exist.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl "https://api.open.cx/connect/threads?status=open&escalated=true&limit=50" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"dark"}
  {
    "data": [
      { "id": "th_9f2c4e", "reference": "order_84421", "status": "open",
        "order_status": "picked_up", "escalations": [{ "session_id": "ses_77a1", "reason": "sentiment", "created_at": "2026-07-30T14:41:02Z" }] }
    ],
    "next_cursor": "eyJvZmZzZXQiOjUwfQ"
  }
  ```
</ResponseExample>