---
title: "Changes to List Payees"
method: GET
path: "/v4/payees"
---

# Changes to List Payees

`GET /v4/payees`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2023-08-15** `b924ba134e09` — 1 info
- **2022-06-27** `1e7a1734a45c` — 14 breaking, 14 info
- **2022-04-07** `da77064fe233` — 1 info
- **2020-09-25** `dd71433847a6` — 4 breaking, 37 info
- **2020-08-13** `75bb7af5ae63` — 1 info
- **2019-07-15** `ced8e167a97c` — 1 breaking

## Changes

- **2023-08-15** `b924ba134e09` — 1 info
  - added the optional property `content/items/managedByPayorId` to the response with the `200` status
- **2022-06-27** `1e7a1734a45c` — 14 breaking, 14 info
  - removed the enum value `CREATED` from the `query` request parameter `onboardedStatus`
  - removed the enum value `Company` from the `query` request parameter `payeeType`
  - removed the enum value `FAILED` from the `query` request parameter `ofacStatus`
  - removed the enum value `FAILED` from the `query` request parameter `watchlistStatus`
  - removed the enum value `INVITED` from the `query` request parameter `onboardedStatus`
  - removed the enum value `Individual` from the `query` request parameter `payeeType`
  - removed the enum value `NONE` from the `query` request parameter `watchlistStatus`
  - removed the enum value `ONBOARDED` from the `query` request parameter `onboardedStatus`
  - removed the enum value `PASSED` from the `query` request parameter `ofacStatus`
  - removed the enum value `PASSED` from the `query` request parameter `watchlistStatus`
  - removed the enum value `PENDING` from the `query` request parameter `ofacStatus`
  - removed the enum value `PENDING` from the `query` request parameter `watchlistStatus`
  - removed the enum value `REGISTERED` from the `query` request parameter `onboardedStatus`
  - removed the enum value `REVIEW` from the `query` request parameter `watchlistStatus`
  - removed the `ACCEPTED` enum value from the `content/items/payorRefs/items/invitationStatus` response property for the response status `200`
  - removed the `CREATED` enum value from the `content/items/onboardedStatus` response property for the response status `200`
  - removed the `Company` enum value from the `content/items/payeeType` response property for the response status `200`
  - removed the `DECLINED` enum value from the `content/items/payorRefs/items/invitationStatus` response property for the response status `200`
  - removed the `FAILED` enum value from the `content/items/watchlistStatus` response property for the response status `200`
  - removed the `INVITED` enum value from the `content/items/onboardedStatus` response property for the response status `200`
  - removed the `Individual` enum value from the `content/items/payeeType` response property for the response status `200`
  - removed the `NONE` enum value from the `content/items/watchlistStatus` response property for the response status `200`
  - removed the `ONBOARDED` enum value from the `content/items/onboardedStatus` response property for the response status `200`
  - removed the `PASSED` enum value from the `content/items/watchlistStatus` response property for the response status `200`
  - removed the `PENDING` enum value from the `content/items/payorRefs/items/invitationStatus` response property for the response status `200`
  - removed the `PENDING` enum value from the `content/items/watchlistStatus` response property for the response status `200`
  - removed the `REGISTERED` enum value from the `content/items/onboardedStatus` response property for the response status `200`
  - removed the `REVIEW` enum value from the `content/items/watchlistStatus` response property for the response status `200`
- **2022-04-07** `da77064fe233` — 1 info
  - the `content/items/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
- **2020-09-25** `dd71433847a6` — 4 breaking, 37 info
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `400`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `401`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `403`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `404`
  - added the optional property `content/items/payorRefs/items/payableIssues` to the response with the `200` status
  - added the optional property `content/items/payorRefs/items/payableStatus` to the response with the `200` status
  - added the optional property `errors/items/errorCode` to the response with the `400` status
  - added the optional property `errors/items/errorCode` to the response with the `401` status
  - added the optional property `errors/items/errorCode` to the response with the `403` status
  - added the optional property `errors/items/errorCode` to the response with the `404` status
  - added the optional property `errors/items/errorData` to the response with the `400` status
  - added the optional property `errors/items/errorData` to the response with the `401` status
  - added the optional property `errors/items/errorData` to the response with the `403` status
  - added the optional property `errors/items/errorData` to the response with the `404` status
  - added the optional property `errors/items/localisationDetails` to the response with the `400` status
  - added the optional property `errors/items/localisationDetails` to the response with the `401` status
  - added the optional property `errors/items/localisationDetails` to the response with the `403` status
  - added the optional property `errors/items/localisationDetails` to the response with the `404` status
  - added the optional property `httpStatusCode` to the response with the `400` status
  - added the optional property `httpStatusCode` to the response with the `401` status
  - added the optional property `httpStatusCode` to the response with the `403` status
  - added the optional property `httpStatusCode` to the response with the `404` status
  - response property `errors/items/locationType` deprecated
  - response property `errors/items/locationType` deprecated
  - response property `errors/items/locationType` deprecated
  - response property `errors/items/locationType` deprecated
  - response property `errors/items/reasonCode` deprecated
  - response property `errors/items/reasonCode` deprecated
  - response property `errors/items/reasonCode` deprecated
  - response property `errors/items/reasonCode` deprecated
  - removed the `AR` enum value from the `content/items/language` response property for the response status `200`
  - removed the `EN` enum value from the `content/items/language` response property for the response status `200`
  - removed the `ES` enum value from the `content/items/language` response property for the response status `200`
  - removed the `FR` enum value from the `content/items/language` response property for the response status `200`
  - removed the `HE` enum value from the `content/items/language` response property for the response status `200`
  - removed the `HI` enum value from the `content/items/language` response property for the response status `200`
  - removed the `JA` enum value from the `content/items/language` response property for the response status `200`
  - removed the `PT` enum value from the `content/items/language` response property for the response status `200`
  - removed the `RU` enum value from the `content/items/language` response property for the response status `200`
  - removed the `UR` enum value from the `content/items/language` response property for the response status `200`
  - …1 more
- **2020-08-13** `75bb7af5ae63` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/docs/v4/payees/get.md) · [API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) · [Page](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v4/payees/get)
