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

# Get Message Sequence Details via the ChatbotX API

> Use GET /api/v1/sequences/{id} to retrieve full details, engagement metrics, and configuration for a single message sequence in your ChatbotX workspace.

Use this endpoint to fetch the full details of a specific message sequence. Supply the sequence's unique ID as a path parameter to retrieve its configuration, status, and engagement metrics, including open rate and click-through rate.

<Info>
  **GET** `/api/v1/sequences/{id}`
</Info>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique ID of the sequence to retrieve.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://app.chatbotx.io/api/v1/sequences/seq_001 \
    --header 'Authorization: Bearer <token>'
  ```

  ```python Python theme={null}
  import requests

  url = "https://app.chatbotx.io/api/v1/sequences/seq_001"

  headers = {"Authorization": "Bearer <token>"}

  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const options = {
    method: 'GET',
    headers: { Authorization: 'Bearer <token>' }
  };

  fetch('https://app.chatbotx.io/api/v1/sequences/seq_001', options)
    .then(res => res.json())
    .then(res => console.log(res))
    .catch(err => console.error(err));
  ```
</CodeGroup>

## Response

Returns `200 OK` with the full sequence object.

### Response Fields

<ResponseField name="id" type="string" required>
  Unique identifier for the sequence.
</ResponseField>

<ResponseField name="name" type="string" required>
  Display name of the sequence.
</ResponseField>

<ResponseField name="active" type="boolean" required>
  Whether the sequence is currently active and enrolling new subscribers.
</ResponseField>

<ResponseField name="subscribers" type="integer" required>
  Total number of contacts who have ever entered the sequence.
</ResponseField>

<ResponseField name="messages" type="integer" required>
  Total number of messages delivered across all steps of the sequence.
</ResponseField>

<ResponseField name="openRate" type="number | null" required>
  The message open rate as a decimal (e.g., `0.45` for 45%), or `null` if there is no data yet.
</ResponseField>

<ResponseField name="ctr" type="number | null" required>
  The click-through rate as a decimal (e.g., `0.12` for 12%), or `null` if there is no data yet.
</ResponseField>

<ResponseField name="folderId" type="string | null" required>
  The folder this sequence is organised into, or `null` if not in a folder.
</ResponseField>

<ResponseField name="workspaceId" type="string" required>
  The ID of the workspace this sequence belongs to.
</ResponseField>

<ResponseField name="createdAt" type="string" required>
  ISO 8601 timestamp for when the sequence was created.
</ResponseField>

<ResponseField name="updatedAt" type="string" required>
  ISO 8601 timestamp for when the sequence was last updated.
</ResponseField>

### Example Response

```json theme={null}
{
  "id": "seq_001",
  "name": "7-Day Onboarding",
  "active": true,
  "subscribers": 1350,
  "messages": 8450,
  "openRate": 0.61,
  "ctr": 0.18,
  "folderId": null,
  "workspaceId": "42",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2024-01-15T10:22:00Z"
}
```