---
title: "Get a journey run"
method: GET
path: "/v1/journeys/{id}/runs/{runId}"
tags: ["Journeys"]
---

# Get a journey run

`GET /v1/journeys/{id}/runs/{runId}`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/journeys/{id}/runs/{runId}`
- Auth: API key in header `x-api-key`

Returns one run with every node it entered, in order: when it entered and left, how it left, and the message a send node created.

## Path parameters

- `id` string, required
- `runId` string, required

## Response `200`

JourneyRunDetail

- JourneyRunDetail
  - `id` string, required
  - `journeyId` string, required
  - `version` integer, required
  - `contactId` string, required
  - `status` 'active' | 'paused' | 'exited' | 'failed', required
  - `exitReason` 'completed' | 'goal' | 'archived', required
  - `failureReason` string, nullable, required
  - `currentNodeId` string, required
  - `holdReason` string, nullable, required
  - `holdUntil` string, nullable, required
  - `trigger` JourneyRunTrigger, required
    - `eventId` string, required
    - `eventName` string, required
    - `properties` JsonObject, required
  - `enteredAt` string, required
  - `endedAt` string, nullable, required
  - `steps` JourneyRunStep[], required
    - `nodeId` string, required
    - `type` string, required
    - `enteredAt` string, required
    - `completedAt` string, nullable, required
    - `outcome` 'completed' | 'matched' | 'timed_out' | 'goal' | 'archived' | 'failed', required
    - `nextNodeId` string, required
    - `messageId` string, required
    - `error` string, nullable, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `404`: ResourceNotFoundError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

[API](https://skmtc.dev/samva/apis/samva-api.md) · [All operations](https://skmtc.dev/samva/apis/samva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/samva/apis/samva-api/revisions/a99408542cc3?raw)