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

# Changes to List Payees

`GET /v3/payees`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 50 revisions.

- **2022-06-27** `1e7a1734a45c` — 11 breaking, 14 info
- **2022-04-07** `da77064fe233` — 1 info
- **2020-09-25** `dd71433847a6` — 4 breaking, 37 info
- **2020-08-13** `75bb7af5ae63` — 1 info
- **2020-06-24** `aded220b0d7b` — 7 breaking, 9 warning, 7 info
- **2020-02-27** `7c8cfeb59952` — 11 breaking, 14 warning, 7 info
- **2020-02-03** `68f50053dc40` — 5 breaking, 3 warning, 16 info
- **2020-01-28** `1b2abf26b5d6` — 2 breaking, 3 warning, 8 info
- **2019-11-25** `86699f3efd3a` — 1 info
- **2019-07-15** `ced8e167a97c` — 1 info

## Changes

- **2022-06-27** `1e7a1734a45c` — 11 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 `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 `watchlistStatus`
  - 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 deprecated
- **2020-06-24** `aded220b0d7b` — 7 breaking, 9 warning, 7 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `404`
  - the response property `content/items/company/name` became optional for the status `200`
  - the response property `content/items/individual/name` became optional for the status `200`
  - the response property `content/items/individual/name/firstName` became optional for the status `200`
  - the response property `content/items/individual/name/lastName` became optional for the status `200`
  - the `content/items/individual/name` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `errors/items/` response's property type/format changed from `object`/`` to ``/`` for status `404`
  - deleted the `query` request parameter `Email`
  - deleted the `query` request parameter `ofacStatus`
  - removed the optional property `content/items/acceptTermsAndConditionsTimestamp` from the response with the `200` status
  - removed the optional property `content/items/address` from the response with the `200` status
  - removed the optional property `content/items/cellphoneNumber` from the response with the `200` status
  - removed the optional property `content/items/challenge` from the response with the `200` status
  - removed the optional property `content/items/gracePeriodEndDate` from the response with the `200` status
  - removed the optional property `content/items/marketingOptIns` from the response with the `200` status
  - removed the optional property `content/items/paymentChannel` from the response with the `200` status
  - added the new optional `query` request parameter `disabled`
  - added the new optional `query` request parameter `email`
  - added the new optional `query` request parameter `watchlistStatus`
  - added the optional property `content/items/disabled` to the response with the `200` status
  - added the optional property `content/items/disabledComment` to the response with the `200` status
  - added the optional property `content/items/disabledUpdatedTimestamp` to the response with the `200` status
  - added the optional property `content/items/watchlistOverrideComment` to the response with the `200` status
- **2020-02-27** `7c8cfeb59952` — 11 breaking, 14 warning, 7 info
  - the `content/items/address/country` response property's maxLength was increased from `2` to `50` for the response status `200`
  - the `content/items/country` response property's maxLength was unset from `2` for the response status `200`
  - the `content/items/country` response property's minLength was decreased from `2` to `0` for the response status `200`
  - the `content/items/individual/name` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `links/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `page` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `page/numberOfElements` response's property type/format changed from `integer`/`int64` to `integer`/`` for status `200`
  - the `page/page` response's property type/format changed from `integer`/`int64` to `integer`/`` for status `200`
  - the `page/pageSize` response's property type/format changed from `integer`/`int64` to `integer`/`` for status `200`
  - the `page/totalElements` response's property type/format changed from `integer`/`int64` to `integer`/`` for status `200`
  - the `page/totalPages` response's property type/format changed from `integer`/`int64` to `integer`/`` for status `200`
  - removed the optional property `content/items/company/taxId` from the response with the `200` status
  - removed the optional property `content/items/disabled` from the response with the `200` status
  - removed the optional property `content/items/disabledComment` from the response with the `200` status
  - removed the optional property `content/items/disabledUpdatedTimestamp` from the response with the `200` status
  - removed the optional property `content/items/enhancedKycCompleted` from the response with the `200` status
  - removed the optional property `content/items/individual/dateOfBirth` from the response with the `200` status
  - removed the optional property `content/items/individual/nationalIdentification` from the response with the `200` status
  - removed the optional property `content/items/kycCompletedTimestamp` from the response with the `200` status
  - removed the optional property `content/items/marketingOptInDecision` from the response with the `200` status
  - removed the optional property `content/items/marketingOptInTimestamp` from the response with the `200` status
  - removed the optional property `content/items/pausePayment` from the response with the `200` status
  - removed the optional property `content/items/pausePaymentTimestamp` from the response with the `200` status
  - removed the optional property `content/items/watchlistOverrideComment` from the response with the `200` status
  - removed the optional property `content/items/watchlistOverrideExpiresAtTimestamp` from the response with the `200` status
  - added the optional property `content/items/challenge` to the response with the `200` status
  - added the optional property `content/items/marketingOptIns` to the response with the `200` status
  - added the optional property `content/items/paymentChannel` to the response with the `200` status
  - the response property `content/items/individual/name/firstName` became required for the status `200`
  - the response property `content/items/individual/name/lastName` became required for the status `200`
  - the `content/items/address/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
  - the `content/items/country` response's property pattern `^[A-Z]{2}$` was removed for the status `200`
- **2020-02-03** `68f50053dc40` — 5 breaking, 3 warning, 16 info
  - the response property `content/items/individual/name/firstName` became optional for the status `200`
  - the response property `content/items/individual/name/lastName` became optional for the status `200`
  - the `content/items/individual/name` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `links/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `page` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed the optional property `content/items/challenge` from the response with the `200` status
  - removed the optional property `content/items/marketingOptIns` from the response with the `200` status
  - removed the optional property `content/items/paymentChannel` from the response with the `200` status
  - added the optional property `content/items/company/taxId` to the response with the `200` status
  - added the optional property `content/items/disabled` to the response with the `200` status
  - added the optional property `content/items/disabledComment` to the response with the `200` status
  - added the optional property `content/items/disabledUpdatedTimestamp` to the response with the `200` status
  - added the optional property `content/items/enhancedKycCompleted` to the response with the `200` status
  - added the optional property `content/items/individual/dateOfBirth` to the response with the `200` status
  - added the optional property `content/items/individual/nationalIdentification` to the response with the `200` status
  - added the optional property `content/items/kycCompletedTimestamp` to the response with the `200` status
  - added the optional property `content/items/marketingOptInDecision` to the response with the `200` status
  - added the optional property `content/items/marketingOptInTimestamp` to the response with the `200` status
  - added the optional property `content/items/pausePayment` to the response with the `200` status
  - added the optional property `content/items/pausePaymentTimestamp` to the response with the `200` status
  - added the optional property `content/items/watchlistOverrideComment` to the response with the `200` status
  - added the optional property `content/items/watchlistOverrideExpiresAtTimestamp` to the response with the `200` status
  - the `content/items/address/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - the `content/items/country` response's property pattern `^[A-Z]{2}$` was added for the status `200`
- **2020-01-28** `1b2abf26b5d6` — 2 breaking, 3 warning, 8 info
  - the `content/items/paymentChannel/countryCode` response property's minLength was decreased from `9` to `2` for the response status `200`
  - removed the required property `content/items/paymentChannel/routingNo` from the response with the `200` status
  - added the new `ACCEPTED` enum value to the `content/items/payorRefs/items/invitationStatus` response property for the response status `200`
  - added the new `DECLINED` enum value to the `content/items/payorRefs/items/invitationStatus` response property for the response status `200`
  - added the new `PENDING` enum value to the `content/items/payorRefs/items/invitationStatus` response property for the response status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the optional property `content/items/payorRefs/items/invitationStatusTimestamp` to the response with the `200` status
  - added the optional property `content/items/payorRefs/items/paymentChannelId` to the response with the `200` status
  - the `content/items/paymentChannel/countryCode` response's property pattern `^[A-Z]{2}$` was added for the status `200`
  - added the required property `content/items/paymentChannel/routingNumber` to the response with the `200` status
- **2019-11-25** `86699f3efd3a` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 info
  - api path removed with deprecation

---

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