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

# Get Journey

> Read a complete SMS welcome journey definition.

Returns the journey definition for an ID in your account. A missing journey, an ID belonging to another account, or a malformed ID returns 404. A malformed ID returns `error: "Journey not found"` with `code: "not_found"`.

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

## Path Parameters

<ParamField path="journey_id" type="string" required>
  Journey ID returned by create or list. A malformed ID returns 404 rather than the journey.
</ParamField>

## Response

The `journey` object uses camelCase: `id`, integer `accountId`, `name`, `trigger`, `priority`, `steps`, `startStepId`, `status`, `pauseReason`, `createdAt`, and `updatedAt`. The trigger can be null. Each step contains `stepId`, `name`, `stepType`, `config`, and nullable `nextStepId`. Pause reasons and absent timestamps can be null.

<ResponseExample>
  ```json 200 theme={null}
  {
    "journey": {
      "id": "664f1a2b3c4d5e6f7a8b9c0d",
      "accountId": 101,
      "name": "Welcome",
      "trigger": {
        "operator": "AND",
        "conditions": [],
        "groups": []
      },
      "priority": 0,
      "steps": [
        {
          "stepId": "done",
          "name": "Exit",
          "stepType": "exit",
          "config": {},
          "nextStepId": null
        }
      ],
      "startStepId": "done",
      "status": "draft",
      "pauseReason": null,
      "createdAt": "2026-09-21T10:00:00",
      "updatedAt": "2026-09-21T10:00:00"
    }
  }
  ```
</ResponseExample>