---
title: "Changes to Retrieve a Payments collection"
method: GET
path: "/payments"
---

# Changes to Retrieve a Payments collection

`GET /payments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `f6d3f87df5e0`: 3 breaking, 8 warning, 7 info

## Changes

- **2026-11-03** `f6d3f87df5e0`: 3 breaking, 8 warning, 7 info
  - the `items/paymentInformation/allOf[#/components/schemas/PaymentInformationDto]/customer_id_hashmac` response property's maxLength was increased from `50` to `64` for the response status `200`
  - the `items/fees/items/taxes/items/` response's property type changed from `string` to `object` for status `200`
  - removed the required property `items/gatewayId` from the response with the `200` status
  - removed the optional property `items/paymentInformation/allOf[#/components/schemas/PaymentInformationDto]/recipient_name_hashmac` from the response with the `200` status
  - removed the optional property `items/paymentInformation/allOf[#/components/schemas/PaymentInformationDto]/recipient_phone_hashmac` from the response with the `200` status
  - removed the optional property `items/paymentInformation/allOf[#/components/schemas/PaymentInformationDto]/transaction_purpose` from the response with the `200` status
  - added the new `consent_reference_in_use` enum value to the `items/failure/allOf[#/components/schemas/PaymentFailureCauseDto]/code` response property for the response status `200`
  - added the new `instant_payment` enum value to the `items/method` response property for the response status `200`
  - added the new `issuer_authentication_unavailable` enum value to the `items/failure/allOf[#/components/schemas/PaymentFailureCauseDto]/code` response property for the response status `200`
  - added the new `recipient_unavailable` enum value to the `items/failure/allOf[#/components/schemas/PaymentFailureCauseDto]/code` response property for the response status `200`
  - added the new `reconciliation_failure` enum value to the `items/failure/allOf[#/components/schemas/PaymentFailureCauseDto]/code` response property for the response status `200`
  - removed the `blacklisted_msisdn` enum value from the `items/failure/allOf[#/components/schemas/PaymentFailureCauseDto]/code` response property for the response status `200`
  - the `items/paymentInformation/allOf[#/components/schemas/PaymentInformationDto]/customer_id_hashmac` response's property pattern `^[0-9a-fA-F]{64}$` was added for the status `200`
  - added the required property `items/fees/items/taxes/items/feeId` to the response with the `200` status
  - added the required property `items/fees/items/taxes/items/id` to the response with the `200` status
  - added the required property `items/fees/items/taxes/items/taxType` to the response with the `200` status
  - added the required property `items/fees/items/taxes/items/type` to the response with the `200` status
  - added the required property `items/fees/items/taxes/items/value` to the response with the `200` status

---

[Operation](https://skmtc.dev/hub2/apis/hub2-service-api/docs/payments/get.md) - [API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [Page](https://skmtc.dev/hub2/apis/hub2-service-api/changes/payments/get)