> ## Documentation Index > Fetch the complete documentation index at: https://docs.serval.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Journey > Fetch a single journey snapshot with tasks, health checks, and workflow failures. ## OpenAPI ````yaml /sections/api-reference/openapi-spec-v2.yaml get /v2/journeys/{id} openapi: 3.1.0 info: title: Serval Public API description: Serval Public API contact: name: Serval url: https://serval.com email: support@serval.com license: name: Serval License url: https://serval.com/license version: 2.0.0 servers: - url: https://public.api.serval.com security: - BearerAuth: [] tags: - name: Access Policy API - name: Access Policy Approval Procedure API - name: Access Profile API - name: Access Relationship API - name: Access Request API - name: Agent Session API - name: App Instance API - name: App Resource API - name: App Resource Role API - name: Approval Delegation API - name: Approval Request API - name: Audit Log API - name: Change Blackout API - name: Change Model API - name: Custom Field API - name: Custom Service API - name: Entity API - name: Entity Field Mapping API - name: Entity Ingestion Config API - name: Entity Type API - name: Folder API - name: Group API - name: Guidance API - name: Help Agent API - name: Journey API - name: Knowledge API - name: Knowledge Base API - name: Report API - name: SLA API - name: Schedule API - name: Tag API - name: Team API - name: Team User API - name: Ticket API - name: Topic API - name: User API - name: User Relationship API - name: Workflow API - name: Workflow Approval Procedure API - name: Workflow Run API paths: /v2/journeys/{id}: get: tags: - Journey API summary: Get Journey description: >- Fetch a single journey snapshot with tasks, health checks, and workflow failures. operationId: svrelay.publicv2.PublicAPIServiceV2.GetJourney parameters: - name: id in: path required: true schema: type: string title: id description: Journey root ticket UUID. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/svhelp.publicapi.GetJourneyResponse' default: description: Error content: application/json: schema: $ref: '#/components/schemas/connect.error' security: - BearerAuth: [] components: schemas: svhelp.publicapi.GetJourneyResponse: type: object properties: data: $ref: '#/components/schemas/svhelp.pubapimodels.Journey' title: data x-stainless-terraform-configurability: optional title: GetJourneyResponse additionalProperties: false connect.error: type: object properties: code: type: string examples: - not_found enum: - canceled - unknown - invalid_argument - deadline_exceeded - not_found - already_exists - permission_denied - resource_exhausted - failed_precondition - aborted - out_of_range - unimplemented - internal - unavailable - data_loss - unauthenticated description: >- The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. x-stainless-terraform-configurability: optional message: type: string description: >- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. x-stainless-terraform-configurability: optional detail: $ref: '#/components/schemas/google.protobuf.Any' x-stainless-terraform-configurability: optional title: Connect Error additionalProperties: true description: >- Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation svhelp.pubapimodels.Journey: type: object properties: id: type: string title: id description: The ID of the journey ticket. readOnly: true x-stainless-terraform-configurability: computed teamId: type: string title: team_id description: The ID of the team that owns the journey. x-stainless-terraform-configurability: optional friendlyIdentifier: type: string title: friendly_identifier description: Friendly identifier such as "ACM-42". readOnly: true x-stainless-terraform-configurability: computed name: type: string title: name description: Journey name. x-stainless-terraform-configurability: optional description: type: string title: description description: Journey description. x-stainless-terraform-configurability: optional createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: created_at description: Timestamp when the journey was created. readOnly: true x-stainless-terraform-configurability: computed requesterUserId: type: string title: requester_user_id description: The user the journey is for. nullable: true x-stainless-terraform-configurability: optional requesterManagerUserId: type: string title: requester_manager_user_id description: The requester's manager (from user relationships). nullable: true x-stainless-terraform-configurability: optional progressPercent: type: integer title: progress_percent format: int32 description: Completion percent across the journey's tasks. x-stainless-terraform-configurability: optional currentTaskIndex: type: integer title: current_task_index format: int32 description: Index of the current in-progress task in tasks[], or -1 when none. x-stainless-terraform-configurability: optional archivedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: archived_at description: When the journey was archived, if any. nullable: true x-stainless-terraform-configurability: optional dueDate: $ref: '#/components/schemas/google.type.Date' title: due_date description: Due date on the journey ticket (date only). nullable: true x-stainless-terraform-configurability: optional metadata: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyMetadata' title: metadata description: Journey-specific metadata (e.g. Onboarding start date). nullable: true x-stainless-terraform-configurability: optional createdByWorkflow: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyWorkflowInfo' title: created_by_workflow description: The workflow that created the journey, if any. nullable: true x-stainless-terraform-configurability: optional tasks: type: array items: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyTask' title: tasks description: |- All tasks and subtasks for the journey, flattened. Top-level tasks have an empty parent_task_id; subtasks reference their task parent. x-stainless-terraform-configurability: optional healthChecks: type: array items: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyHealthCheck' title: health_checks description: Server-computed health checks across the journey. x-stainless-terraform-configurability: optional healthCheckCounts: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyHealthCheckCounts' title: health_check_counts description: Aggregate counts of health_checks by status. x-stainless-terraform-configurability: optional workflowFailures: type: array items: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyWorkflowFailure' title: workflow_failures description: >- Focused failure rows for workflow calls in a failing or denied state. x-stainless-terraform-configurability: optional customFields: type: array items: $ref: '#/components/schemas/svhelp.pubapimodels.CustomFieldValueSummary' title: custom_fields description: Custom fields explicitly set on the top-level journey ticket. x-stainless-terraform-configurability: optional title: Journey additionalProperties: false description: A full journey snapshot returned by GetJourney. google.protobuf.Any: type: object properties: type: type: string x-stainless-terraform-configurability: optional value: type: string format: binary x-stainless-terraform-configurability: optional debug: type: object additionalProperties: true x-stainless-terraform-configurability: optional additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. google.protobuf.Timestamp: type: string format: date-time description: A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z"). google.type.Date: type: object properties: year: type: integer title: year format: int32 description: >- Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. x-stainless-terraform-configurability: optional month: type: integer title: month format: int32 description: >- Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. x-stainless-terraform-configurability: optional day: type: integer title: day format: int32 description: >- Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. x-stainless-terraform-configurability: optional title: Date additionalProperties: false description: >- Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values * A month and day value, with a zero year, such as an anniversary * A year on its own, with zero month and day values * A year and month value, with a zero day, such as a credit card expiration date Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and `google.protobuf.Timestamp`. svhelp.pubapimodels.JourneyMetadata: type: object oneOf: - $ref: '#/components/schemas/svhelp.pubapimodels.JourneyMetadata.Onboarding' title: JourneyMetadata description: Metadata for a journey, shown at the top of the journey view. svhelp.pubapimodels.JourneyWorkflowInfo: type: object properties: id: type: string title: id x-stainless-terraform-configurability: optional name: type: string title: name x-stainless-terraform-configurability: optional title: JourneyWorkflowInfo additionalProperties: false description: Reference to a workflow. svhelp.pubapimodels.JourneyTask: type: object properties: id: type: string title: id description: The ID of the task ticket. x-stainless-terraform-configurability: optional parentTaskId: type: string title: parent_task_id description: Empty for top-level tasks; subtask rows reference their task parent. x-stainless-terraform-configurability: optional name: type: string title: name description: Task name. x-stainless-terraform-configurability: optional description: type: string title: description description: Task description. x-stainless-terraform-configurability: optional status: $ref: '#/components/schemas/svhelp.models.JourneyTaskStatus' title: status description: Computed status of the task within the journey graph. x-stainless-terraform-configurability: optional dependsOnIds: type: array items: type: string title: depends_on_ids description: IDs of tasks/subtasks this task depends on. x-stainless-terraform-configurability: optional assignedToUserId: type: string title: assigned_to_user_id description: The user assigned to the task, if any. nullable: true x-stainless-terraform-configurability: optional dueDate: $ref: '#/components/schemas/google.type.Date' title: due_date description: Due date on the task ticket (date only). nullable: true x-stainless-terraform-configurability: optional isOverdue: type: boolean title: is_overdue description: True if the due date has passed. x-stainless-terraform-configurability: computed_optional isStatusCheck: type: boolean title: is_status_check description: True when the task is driven by a status_check workflow. x-stainless-terraform-configurability: computed_optional pollingIntervalMs: type: - integer - string title: polling_interval_ms format: int64 description: Polling interval in milliseconds for status_check tasks. nullable: true x-stainless-terraform-configurability: optional latestWorkflowCall: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyTaskWorkflowCall' title: latest_workflow_call description: |- Latest submitted workflow_call summary. For status_check tasks, only the most recent poll is returned. nullable: true x-stainless-terraform-configurability: optional title: JourneyTask additionalProperties: false description: A task or subtask within a journey. svhelp.pubapimodels.JourneyHealthCheck: type: object properties: id: type: string title: id description: |- Stable ID for the check (workflow_call ID for workflow-run checks, synthesized for overdue/unassigned checks). x-stainless-terraform-configurability: optional type: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyHealthCheckType' title: type x-stainless-terraform-configurability: optional status: $ref: '#/components/schemas/svhelp.pubapimodels.JourneyHealthCheckStatus' title: status x-stainless-terraform-configurability: optional taskId: type: string title: task_id description: The top-level task this check belongs to. x-stainless-terraform-configurability: optional subtaskId: type: string title: subtask_id description: |- The subtask the check actually attaches to. Equal to task_id when the check applies to the top-level task itself. x-stainless-terraform-configurability: optional workflowId: type: string title: workflow_id nullable: true x-stainless-terraform-configurability: optional workflowName: type: string title: workflow_name nullable: true x-stainless-terraform-configurability: optional workflowCallId: type: string title: workflow_call_id nullable: true x-stainless-terraform-configurability: optional runId: type: string title: run_id nullable: true x-stainless-terraform-configurability: optional dueDate: $ref: '#/components/schemas/google.type.Date' title: due_date nullable: true x-stainless-terraform-configurability: optional title: JourneyHealthCheck additionalProperties: false description: A single health check row across a journey. svhelp.pubapimodels.JourneyHealthCheckCounts: type: object properties: totalCount: type: integer title: total_count format: int32 x-stainless-terraform-configurability: optional failingCount: type: integer title: failing_count format: int32 x-stainless-terraform-configurability: optional warningCount: type: integer title: warning_count format: int32 x-stainless-terraform-configurability: optional passingCount: type: integer title: passing_count format: int32 x-stainless-terraform-configurability: optional runningCount: type: integer title: running_count format: int32 x-stainless-terraform-configurability: optional noDataCount: type: integer title: no_data_count format: int32 x-stainless-terraform-configurability: optional canceledCount: type: integer title: canceled_count format: int32 x-stainless-terraform-configurability: optional title: JourneyHealthCheckCounts additionalProperties: false description: Aggregate counts of health checks across a journey. svhelp.pubapimodels.JourneyWorkflowFailure: type: object properties: workflowCallId: type: string title: workflow_call_id x-stainless-terraform-configurability: optional runId: type: string title: run_id nullable: true x-stainless-terraform-configurability: optional runStatus: $ref: '#/components/schemas/svflow.common.models.WorkflowRunStatus' title: run_status x-stainless-terraform-configurability: optional workflowId: type: string title: workflow_id x-stainless-terraform-configurability: optional workflowName: type: string title: workflow_name x-stainless-terraform-configurability: optional taskId: type: string title: task_id x-stainless-terraform-configurability: optional subtaskId: type: string title: subtask_id x-stainless-terraform-configurability: optional validationErrors: $ref: '#/components/schemas/svflow.common.models.ValidationErrors' title: validation_errors nullable: true x-stainless-terraform-configurability: optional statusCheckResult: $ref: '#/components/schemas/svflow.common.models.StatusCheckResult' title: status_check_result nullable: true x-stainless-terraform-configurability: optional runResult: type: string title: run_result description: Raw workflow run output. nullable: true x-stainless-terraform-configurability: optional runCompletedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: run_completed_at description: When the workflow run reached its terminal failure state. nullable: true readOnly: true x-stainless-terraform-configurability: computed title: JourneyWorkflowFailure additionalProperties: false description: Detail for a workflow_call in a failing or denied state. svhelp.pubapimodels.CustomFieldValueSummary: type: object properties: fieldId: type: string title: field_id x-stainless-terraform-configurability: optional fieldKey: type: string title: field_key x-stainless-terraform-configurability: optional fieldName: type: string title: field_name x-stainless-terraform-configurability: optional dataType: $ref: '#/components/schemas/svstore.EntityTypeField.DataType' title: data_type x-stainless-terraform-configurability: optional value: $ref: '#/components/schemas/google.protobuf.Value' title: value x-stainless-terraform-configurability: optional title: CustomFieldValueSummary additionalProperties: false svhelp.pubapimodels.JourneyMetadata.Onboarding: type: object title: Onboarding properties: onboarding: $ref: '#/components/schemas/svhelp.pubapimodels.OnboardingJourneyMetadata' title: onboarding x-stainless-terraform-configurability: optional welcomeTitle: type: string title: welcome_title description: >- Salutation shown at the top of the journey view, common to every journey type. welcome_title overrides the default heading; welcome_body overrides the default body copy and supersedes the legacy OnboardingJourneyMetadata.welcome_message. nullable: true x-stainless-terraform-configurability: optional welcomeBody: type: string title: welcome_body nullable: true x-stainless-terraform-configurability: optional required: - onboarding additionalProperties: false svhelp.models.JourneyTaskStatus: type: string title: JourneyTaskStatus enum: - JOURNEY_TASK_STATUS_UNSPECIFIED - JOURNEY_TASK_STATUS_COMPLETE - JOURNEY_TASK_STATUS_CURRENT - JOURNEY_TASK_STATUS_BLOCKED - JOURNEY_TASK_STATUS_IN_PROGRESS description: |- JourneyTaskStatus represents the computed status of a journey task based on its ticket status and dependency state. svhelp.pubapimodels.JourneyTaskWorkflowCall: type: object properties: id: type: string title: id description: The workflow call ID. x-stainless-terraform-configurability: optional workflowId: type: string title: workflow_id description: The workflow ID. x-stainless-terraform-configurability: optional workflowName: type: string title: workflow_name description: The workflow name. x-stainless-terraform-configurability: optional runId: type: string title: run_id description: The workflow run ID, if a run was started. nullable: true x-stainless-terraform-configurability: optional runStatus: $ref: '#/components/schemas/svflow.common.models.WorkflowRunStatus' title: run_status description: Current run status. x-stainless-terraform-configurability: optional createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: created_at description: When the workflow call was created. x-stainless-terraform-configurability: optional formConfirmationRequired: type: boolean title: form_confirmation_required description: |- True when this call requires the assignee to confirm the form before the workflow runs. x-stainless-terraform-configurability: computed_optional formConfirmationResponse: type: boolean title: form_confirmation_response description: Whether the assignee confirmed (true) or rejected (false) the form. nullable: true x-stainless-terraform-configurability: computed_optional statusUpdatedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: status_updated_at description: When the current run status was last updated, if known. nullable: true readOnly: true x-stainless-terraform-configurability: computed title: JourneyTaskWorkflowCall additionalProperties: false description: Summary of the latest workflow_call associated with a journey task. svhelp.pubapimodels.JourneyHealthCheckType: type: string title: JourneyHealthCheckType enum: - JOURNEY_HEALTH_CHECK_TYPE_UNSPECIFIED - JOURNEY_HEALTH_CHECK_TYPE_WORKFLOW_RUN - JOURNEY_HEALTH_CHECK_TYPE_OVERDUE_TASK - JOURNEY_HEALTH_CHECK_TYPE_UNASSIGNED_TASK description: The category of a journey health check. svhelp.pubapimodels.JourneyHealthCheckStatus: type: string title: JourneyHealthCheckStatus enum: - JOURNEY_HEALTH_CHECK_STATUS_UNSPECIFIED - JOURNEY_HEALTH_CHECK_STATUS_PASSING - JOURNEY_HEALTH_CHECK_STATUS_FAILING - JOURNEY_HEALTH_CHECK_STATUS_WARNING - JOURNEY_HEALTH_CHECK_STATUS_RUNNING - JOURNEY_HEALTH_CHECK_STATUS_NO_DATA - JOURNEY_HEALTH_CHECK_STATUS_CANCELED description: The current state of a journey health check. svflow.common.models.WorkflowRunStatus: type: string title: WorkflowRunStatus enum: - WORKFLOW_RUN_STATUS_UNSPECIFIED - WORKFLOW_RUN_STATUS_PENDING - WORKFLOW_RUN_STATUS_RUNNING - WORKFLOW_RUN_STATUS_COMPLETED - WORKFLOW_RUN_STATUS_FAILED - WORKFLOW_RUN_STATUS_DENIED - WORKFLOW_RUN_STATUS_CANCELED svflow.common.models.ValidationErrors: type: object properties: displayMessage: type: string title: display_message description: General banner message shown above the form. x-stainless-terraform-configurability: optional fieldErrors: type: object title: field_errors additionalProperties: type: string title: value description: Per-field error messages. Keys are workflow input parameter names. x-stainless-terraform-configurability: optional translations: type: object title: translations additionalProperties: $ref: >- #/components/schemas/svflow.common.models.ValidationErrorTranslations title: value description: >- Per-language translations of error messages. Key = BCP 47 language code. x-stainless-terraform-configurability: optional title: ValidationErrors additionalProperties: false description: Validation error details surfaced from a workflow's ValidationError. svflow.common.models.StatusCheckResult: type: object properties: isComplete: type: boolean title: is_complete x-stainless-terraform-configurability: computed_optional message: type: string title: message description: The message appropriate for the current status (pending or success). x-stainless-terraform-configurability: optional messageTranslations: type: object title: message_translations additionalProperties: type: string title: value description: Per-language translations of the message. Key = BCP 47 code. x-stainless-terraform-configurability: optional title: StatusCheckResult additionalProperties: false svstore.EntityTypeField.DataType: type: string title: DataType enum: - DATA_TYPE_UNSPECIFIED - TEXT - NUMBER - BOOL - TIMESTAMP - ENUM - ENTITY_REF - USER_REF - UNIQUE - MULTI_SELECT - FILE google.protobuf.Value: oneOf: - type: 'null' - type: number - type: string - type: boolean - type: array - type: object additionalProperties: true description: |- `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. The JSON representation for `Value` is JSON value. svhelp.pubapimodels.OnboardingJourneyMetadata: type: object properties: startDate: $ref: '#/components/schemas/google.type.Date' title: start_date x-stainless-terraform-configurability: optional welcomeMessage: type: string title: welcome_message nullable: true x-stainless-terraform-configurability: optional title: OnboardingJourneyMetadata additionalProperties: false description: Metadata for an onboarding journey. svflow.common.models.ValidationErrorTranslations: type: object properties: displayMessage: type: string title: display_message x-stainless-terraform-configurability: optional fieldErrors: type: object title: field_errors additionalProperties: type: string title: value x-stainless-terraform-configurability: optional title: ValidationErrorTranslations additionalProperties: false securitySchemes: BearerAuth: type: http scheme: bearer ````