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

# List Journeys

> List SMS welcome journeys for your account.

Lists journeys by descending priority, then newest creation time. Results and enrollment warnings are scoped to your account.

Declares the `journeys.read` scope. Authenticate with `X-Api-Key`; see [Authentication](/api-reference/authentication).

## Query Parameters

<ParamField query="page" type="integer">
  Page number. Default: 1. Use a positive value.
</ParamField>

<ParamField query="per_page" type="integer">
  Items per page. Default: 50; maximum: 100. Use a positive value.
</ParamField>

<ParamField query="status" type="string">
  Filter by draft, active, paused, or archived. Unrecognized values are ignored.
</ParamField>

<ParamField query="search" type="string">
  Case-insensitive substring search on the journey name.
</ParamField>

## Response

The compact journey object contains `id`, `name`, `priority`, `triggerSummary`, `stepCount`, `enrolledCount`, `completedCount`, `status`, `pauseReason`, `createdAt`, and `updatedAt`. It omits the account ID, trigger definition, and steps. Use [Get Journey](/api-reference/v2/journeys/get-journey) for the full definition.

<ResponseField name="journeys" type="array of objects">
  Compact journey summaries.
</ResponseField>

<ResponseField name="pagination" type="object">
  Uses camelCase: page, perPage, total, and totalPages.
</ResponseField>

<ResponseField name="warnings" type="array of strings">
  Present only when active journeys have no enrollments despite recent contacts. Warnings can refer to active journeys outside the current page or filter.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "journeys": [
      {
        "id": "664f1a2b3c4d5e6f7a8b9c0d",
        "name": "Welcome",
        "priority": 0,
        "triggerSummary": "No trigger",
        "stepCount": 1,
        "enrolledCount": 0,
        "completedCount": 0,
        "status": "draft",
        "pauseReason": null,
        "createdAt": "2026-09-21T10:00:00",
        "updatedAt": "2026-09-21T10:00:00"
      }
    ],
    "pagination": {
      "page": 1,
      "perPage": 50,
      "total": 1,
      "totalPages": 1
    }
  }
  ```
</ResponseExample>