---
title: "Changes to List transactions"
method: GET
path: "/v2.1/merchants/{merchant_code}/transactions/history"
---

# Changes to List transactions

`GET /v2.1/merchants/{merchant_code}/transactions/history`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 12 of 53 revisions.

- **2026-07-10** `c75ca16e1e44` — 1 info
- **2026-06-18** `89d32e0b22e2` — 3 warning, 3 info
- **2026-05-20** `3b883d8c8a7c` — 1 warning
- **2026-03-24** `bc466839f97d` — 1 info
- **2026-03-11** `cd79d83b07e0` — 3 warning, 7 info
- **2026-02-25** `bef1083e0580` — 1 breaking, 2 warning, 5 info
- **2026-01-19** `e28f194df27e` — 10 warning, 1 info
- **2025-12-18** `132e5091a885` — 7 warning, 4 info
- **2025-11-25** `b0fd605a4929` — 2 info
- **2025-11-17** `200136cdef81` — 1 warning
- **2025-02-25** `cdadac3315a1` — 2 info
- **2024-12-20** `9d3d2c99f041` — 1 info

## Changes

- **2026-07-10** `c75ca16e1e44` — 1 info
  - the security scope `transactions.read` was added to the endpoint's security scheme `oauth2`
- **2026-06-18** `89d32e0b22e2` — 3 warning, 3 info
  - deleted the `query` request parameter `payment_types`
  - deleted the `query` request parameter `types`
  - deleted the `query` request parameter `users`
  - added the new optional `query` request parameter `payment_types[]`
  - added the new optional `query` request parameter `types[]`
  - added the new optional `query` request parameter `users[]`
- **2026-05-20** `3b883d8c8a7c` — 1 warning
  - added the new `REFUNDED` enum value to the `items/items/allOf[subschema #1: Transaction Base]/status` response property for the response status `200`
- **2026-03-24** `bc466839f97d` — 1 info
  - added the enum value `TWINT` to the property `items/` of the `query` request parameter `entry_modes[]`
- **2026-03-11** `cd79d83b07e0` — 3 warning, 7 info
  - deleted the `query` request parameter `statuses`
  - removed the optional property `error_code` from the response with the `401` status
  - removed the optional property `message` from the response with the `401` status
  - added the new optional `query` request parameter `statuses[]`
  - added the non-success response with the status `400`
  - added the optional property `detail` to the response with the `401` status
  - added the optional property `instance` to the response with the `401` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `title` to the response with the `401` status
  - added the required property `type` to the response with the `401` status
- **2026-02-25** `bef1083e0580` — 1 breaking, 2 warning, 5 info
  - the `links/items/href` response's property type/format changed from `string`/`uri` to `string`/`` for status `200`
  - removed the optional property `links/items/type` from the response with the `200` status
  - added the new `COP` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/currency` response property for the response status `200`
  - added the optional property `items/items/allOf[subschema #3]/payout_date` to the response with the `200` status
  - added the optional property `items/items/allOf[subschema #3]/payout_type` to the response with the `200` status
  - added the optional property `items/items/allOf[subschema #3]/refunded_amount` to the response with the `200` status
  - the response property `links/items/href` became required for the status `200`
  - the response property `links/items/rel` became required for the status `200`
- **2026-01-19** `e28f194df27e` — 10 warning, 1 info
  - added the new `ALELO` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `CONECS` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `EFTPOS` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `GIROCARD` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `INTERAC` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `PLUXEE` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `SWILE` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `TICKET` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `VPAY` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new `VR` enum value to the `items/items/allOf[subschema #3]/card_type` response property for the response status `200`
  - added the new optional `query` request parameter `entry_modes[]`
- **2025-12-18** `132e5091a885` — 7 warning, 4 info
  - added the new `APM` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/payment_type` response property for the response status `200`
  - added the new `BALANCE` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/payment_type` response property for the response status `200`
  - added the new `BITCOIN` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/payment_type` response property for the response status `200`
  - added the new `CASH` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/payment_type` response property for the response status `200`
  - added the new `DIRECT_DEBIT` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/payment_type` response property for the response status `200`
  - added the new `MOTO` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/payment_type` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `items/items/allOf[#/components/schemas/TransactionBase]/payment_type` response property for the response status `200`
  - added the enum value `APM` to the property `items/` of the `query` request parameter `payment_types`
  - added the enum value `BITCOIN` to the property `items/` of the `query` request parameter `payment_types`
  - added the enum value `DIRECT_DEBIT` to the property `items/` of the `query` request parameter `payment_types`
  - added the enum value `RECURRING` to the property `items/` of the `query` request parameter `payment_types`
- **2025-11-25** `b0fd605a4929` — 2 info
  - added `#/components/schemas/TransactionBase` to the `items/items/` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/TransactionMixinBase` from the `items/items/` response property `allOf` list for the response status `200`
- **2025-11-17** `200136cdef81` — 1 warning
  - added the new `POS` enum value to the `items/items/allOf[#/components/schemas/TransactionMixinBase]/payment_type` response property for the response status `200`
- **2025-02-25** `cdadac3315a1` — 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `oauth2` was added to the API
- **2024-12-20** `9d3d2c99f041` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/sumup/apis/sumup-rest-api/docs/v2.1/merchants/:merchant_code/transactions/history/get.md) · [API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) · [Page](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v2.1/merchants/:merchant_code/transactions/history/get)
