--- title: "List Journeys" method: GET path: "/v2/teams/{team_id}/journeys" tags: ["Journey API"] --- # List Journeys `GET /v2/teams/{team_id}/journeys` List lean journey rows for a team. Returns identity, requester, progress, and health check counts per journey; call GetJourney for tasks and workflow failures. ## Path parameters - `team_id` string, required — The ID of the team to list journeys for. ## Query parameters - `filterGroups.predicates.requester.operator` 'SET_OPERATOR_UNSPECIFIED' | 'SET_OPERATOR_INCLUDES' | 'SET_OPERATOR_EXCLUDES' - `filterGroups.predicates.requester.userIds` string[] - `filterGroups.predicates.requester.currentUser` boolean - `filterGroups.predicates.requester.none` boolean - `filterGroups.predicates.workflow.workflowIds` string[] - `filterGroups.predicates.completion.operator` 'COMPARISON_OPERATOR_UNSPECIFIED' | 'COMPARISON_OPERATOR_EQ' | 'COMPARISON_OPERATOR_NE' | 'COMPARISON_OPERATOR_GT' | 'COMPARISON_OPERATOR_GTE' | 'COMPARISON_OPERATOR_LT' | 'COMPARISON_OPERATOR_LTE' - `filterGroups.predicates.completion.value` integer - `filterGroups.predicates.healthChecks.operator` 'SET_OPERATOR_UNSPECIFIED' | 'SET_OPERATOR_INCLUDES' | 'SET_OPERATOR_EXCLUDES' - `filterGroups.predicates.healthChecks.statuses` SvhelpModelsHealthCheckRollupStatus[] - `filterGroups.predicates.dueDate.hasDueDate` boolean — If true, only include items that have a due date set. - `filterGroups.predicates.dueDate.isOverdue` boolean — If true, only include items that are overdue (due date before today). - `filterGroups.predicates.dueDate.dueBefore.year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `filterGroups.predicates.dueDate.dueBefore.month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `filterGroups.predicates.dueDate.dueBefore.day` integer — 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. - `filterGroups.predicates.customFields.filters.fieldId` string - `filterGroups.predicates.customFields.filters.fieldKey` string - `filterGroups.predicates.customFields.filters.text.eq` string - `filterGroups.predicates.customFields.filters.text.ne` string - `filterGroups.predicates.customFields.filters.text.contains` string - `filterGroups.predicates.customFields.filters.text.startsWith` string - `filterGroups.predicates.customFields.filters.text.endsWith` string - `filterGroups.predicates.customFields.filters.text.doesNotContain` string - `filterGroups.predicates.customFields.filters.text.like` string - `filterGroups.predicates.customFields.filters.text.inList.values` string[] - `filterGroups.predicates.customFields.filters.number.eq` number, double - `filterGroups.predicates.customFields.filters.number.ne` number, double - `filterGroups.predicates.customFields.filters.number.gt` number, double - `filterGroups.predicates.customFields.filters.number.gte` number, double - `filterGroups.predicates.customFields.filters.number.lt` number, double - `filterGroups.predicates.customFields.filters.number.lte` number, double - `filterGroups.predicates.customFields.filters.boolValue.eq` boolean - `filterGroups.predicates.customFields.filters.boolValue.ne` boolean - `filterGroups.predicates.customFields.filters.timestamp.eq.seconds` union — Unix timestamp in seconds. - integer - string, int64 - `filterGroups.predicates.customFields.filters.enumValue.eq` string - `filterGroups.predicates.customFields.filters.enumValue.ne` string - `filterGroups.predicates.customFields.filters.multiSelectValue.contains` string - `filterGroups.predicates.customFields.filters.multiSelectValue.doesNotContain` string - `filterGroups.predicates.customFields.sourceFilter.eq` string - `filterGroups.predicates.customFields.sourceFilter.ne` string - `filterGroups.predicates.search.query` string - `sort.field` 'JOURNEY_SORT_FIELD_UNSPECIFIED' | 'JOURNEY_SORT_FIELD_CREATED_AT' | 'JOURNEY_SORT_FIELD_REQUESTER' | 'JOURNEY_SORT_FIELD_NAME' | 'JOURNEY_SORT_FIELD_COMPLETION' | 'JOURNEY_SORT_FIELD_MANAGER' | 'JOURNEY_SORT_FIELD_HEALTH_CHECKS' | 'JOURNEY_SORT_FIELD_DUE_DATE' | 'JOURNEY_SORT_FIELD_CHATS' - `sort.direction` 'SORT_DIRECTION_UNSPECIFIED' | 'SORT_DIRECTION_ASC' | 'SORT_DIRECTION_DESC' - `sort.customFieldId` string — When field is UNSPECIFIED and custom_field_id is set, sort by this custom field. - `pageSize` integer — Defaults to 100 when unset. Must be between 1 and 250; values outside that range produce a 400 InvalidArgument. - `pageToken` string — Opaque cursor returned by a previous response. When provided, the same team_id / filter_groups / sort must be sent. ## Response `200` Success - SvhelpPublicapiListJourneysResponse - `data` SvhelpPubapimodelsJourneySummary[] - `id` string — The ID of the journey ticket. - `teamId` string — The ID of the team that owns the journey. - `friendlyIdentifier` string — Friendly identifier such as "ACM-42". - `name` string — Journey name. - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z"). - `requesterUserId` string, nullable — The user the journey is for. - `requesterManagerUserId` string, nullable — The requester's manager (from user relationships). - `progressPercent` integer — Completion percent across the journey's tasks. - `archivedAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z"). - `dueDate` GoogleTypeDate — 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, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * [google.type.TimeOfDay][google.type.TimeOfDay] * [google.type.DateTime][google.type.DateTime] * [google.protobuf.Timestamp][google.protobuf.Timestamp] - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `day` integer — 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. - `metadata` SvhelpPubapimodelsJourneyMetadata — Metadata for a journey, shown at the top of the journey view. - `onboarding` SvhelpPubapimodelsOnboardingJourneyMetadata, required — Metadata for an onboarding journey. - `startDate` GoogleTypeDate — 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, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * [google.type.TimeOfDay][google.type.TimeOfDay] * [google.type.DateTime][google.type.DateTime] * [google.protobuf.Timestamp][google.protobuf.Timestamp] - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `day` integer — 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. - `welcomeMessage` string, nullable - `welcomeTitle` string, nullable — 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. - `welcomeBody` string, nullable - `createdByWorkflow` SvhelpPubapimodelsJourneyWorkflowInfo — Reference to a workflow. - `id` string - `name` string - `healthCheckCounts` SvhelpPubapimodelsJourneyHealthCheckCounts — Aggregate counts of health checks across a journey. - `totalCount` integer - `failingCount` integer - `warningCount` integer - `passingCount` integer - `runningCount` integer - `noDataCount` integer - `canceledCount` integer - `workflowFailureCount` integer — Number of workflow failures GetJourney would return for this journey. - `customFields` SvhelpPubapimodelsCustomFieldValueSummary[] — Custom fields explicitly set on the top-level journey ticket. - `fieldId` string - `fieldKey` string - `fieldName` string - `dataType` 'DATA_TYPE_UNSPECIFIED' | 'TEXT' | 'NUMBER' | 'BOOL' | 'TIMESTAMP' | 'ENUM' | 'ENTITY_REF' | 'USER_REF' | 'UNIQUE' | 'MULTI_SELECT' | 'FILE' - `value` union — `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. - number - string - boolean - object - `nextPageToken` string, nullable — Empty when there are no more pages. - `totalCount` integer — Number of journeys matching the filters across all pages. - `teamTotalCount` integer — Number of journeys for the team, ignoring filters. ## Other responses - `default` — Error --- [API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)