---
title: "Changes to Search User Journeys"
method: GET
path: "/api/v2/user_journeys"
---

# Changes to Search User Journeys

`GET /api/v2/user_journeys`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 19 revisions.

- **2026-03-20** `f30bd25c50fa` — 1 warning
- **2026-03-09** `fd9ba8047579` — 2 info
- **2026-03-09** `3f638e7bcdd4` — 5 breaking, 27 warning, 10 info
- **2025-07-31** `33c1d5958395` — 1 warning, 1 info
- **2025-05-19** `805744a185fa` — 1 info
- **2024-06-11** `6cde27481f55` — 1 breaking

## Changes

- **2026-03-20** `f30bd25c50fa` — 1 warning
  - added the new `voided` enum value to the `items/state` response property for the response status `200`
- **2026-03-09** `fd9ba8047579` — 2 info
  - added `#/components/schemas/Models.OfficeLocation` to the `items/office_location` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/OfficeLocation` from the `items/office_location` response property `anyOf` list for the response status `200`
- **2026-03-09** `3f638e7bcdd4` — 5 breaking, 27 warning, 10 info
  - the `items/custom_field_values` response's property type/format changed from ``/`` to `array`/`` for status `200`
  - the `items/office_location` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `items/state` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - removed the required property `items/office_location/external_ids` from the response with the `200` status
  - removed the required property `items/office_location/id` from the response with the `200` status
  - removed the optional property `items/office_location/address1` from the response with the `200` status
  - removed the optional property `items/office_location/address2` from the response with the `200` status
  - removed the optional property `items/office_location/address3` from the response with the `200` status
  - removed the optional property `items/office_location/city` from the response with the `200` status
  - removed the optional property `items/office_location/country` from the response with the `200` status
  - removed the optional property `items/office_location/latitude` from the response with the `200` status
  - removed the optional property `items/office_location/longitude` from the response with the `200` status
  - removed the optional property `items/office_location/postal_code` from the response with the `200` status
  - removed the optional property `items/office_location/region` from the response with the `200` status
  - removed the optional property `items/office_location/state` from the response with the `200` status
  - removed the optional property `items/office_location/time_zone` from the response with the `200` status
  - removed the optional property `items/office_location/workday` from the response with the `200` status
  - added the new `approved` enum value to the `items/state` response property for the response status `200`
  - added the new `completed` enum value to the `items/state` response property for the response status `200`
  - added the new `declined` enum value to the `items/state` response property for the response status `200`
  - added the new `draft` enum value to the `items/state` response property for the response status `200`
  - added the new `needs_attention` enum value to the `items/state` response property for the response status `200`
  - added the new `offboarding` enum value to the `items/transition_type` response property for the response status `200`
  - added the new `offer` enum value to the `items/transition_type` response property for the response status `200`
  - added the new `onboarding` enum value to the `items/transition_type` response property for the response status `200`
  - added the new `pending_approval` enum value to the `items/state` response property for the response status `200`
  - added the new `post_offer` enum value to the `items/transition_type` response property for the response status `200`
  - added the new `pre_offer` enum value to the `items/transition_type` response property for the response status `200`
  - added the new `rejected` enum value to the `items/state` response property for the response status `200`
  - added the new `rescinded` enum value to the `items/state` response property for the response status `200`
  - added the new `submitted` enum value to the `items/state` response property for the response status `200`
  - added the new `user_pending` enum value to the `items/state` response property for the response status `200`
  - removed `#/components/schemas/CustomFieldsValueObject` from the `items/custom_field_values` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/UserJourneyState` from the `items/state` response property `allOf` list for the response status `200`
  - added `#/components/schemas/OfficeLocation, subschema #2` to the `items/office_location` response property `anyOf` list for the response status `200`
  - the response property `items/created_at` became required for the status `200`
  - the response property `items/custom_field_values` became required for the status `200`
  - the response property `items/office_location` became required for the status `200`
  - the response property `items/state` became required for the status `200`
  - the response property `items/transition_type` became required for the status `200`
  - …2 more
- **2025-07-31** `33c1d5958395` — 1 warning, 1 info
  - removed the optional property `items/journey_type` from the response with the `200` status
  - added the optional property `items/transition_type` to the response with the `200` status
- **2025-05-19** `805744a185fa` — 1 info
  - endpoint added
- **2024-06-11** `6cde27481f55` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/xpand-io/apis/xpand-api/docs/api/v2/user_journeys/get.md) · [API](https://skmtc.dev/xpand-io/apis/xpand-api.md) · [Page](https://skmtc.dev/xpand-io/apis/xpand-api/changes/api/v2/user_journeys/get)
