---
title: "List transactions"
method: GET
path: "/v2.1/merchants/{merchant_code}/transactions/history"
tags: ["Transactions"]
---

# List transactions

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

Lists detailed history of all transactions associated with the merchant profile.

## Path parameters

- `merchant_code` string, required

## Query parameters

- `transaction_code` string
- `order` 'ascending' | 'descending'
- `limit` integer
- `users[]` string[]
- `statuses[]` string[]
- `payment_types[]` PaymentType[]
- `entry_modes[]` EntryMode[]
- `types[]` string[]
- `changes_since` string, date-time
- `newest_time` string, date-time
- `newest_ref` string
- `oldest_time` string, date-time
- `oldest_ref` string

## Response `200`

Returns a page of transaction history items.

- object
  - `items` TransactionHistory[] — Transactions in the current result page.
    - `id` string — Unique identifier of the transaction.
    - `transaction_code` string — Transaction code returned by the acquirer/processing entity after processing the transaction.
    - `amount` number, float — Total amount of the transaction.
    - `currency` 'BGN' | 'BRL' | 'CHF' | 'CLP' | 'COP' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HRK' | 'HUF' | 'NOK' | 'PLN' | 'RON' | 'SEK' | 'USD' — Three-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the amount.
    - `timestamp` string, date-time — The timestamp of when the transaction was created.
    - `status` 'SUCCESSFUL' | 'CANCELLED' | 'FAILED' | 'PENDING' | 'REFUNDED' — Current status of the transaction. - `PENDING`: The transaction has been created but its final outcome is not known yet. - `SUCCESSFUL`: The transaction completed successfully. - `CANCELLED`: The transaction was cancelled or otherwise reversed before completion. - `FAILED`: The transaction attempt did not complete successfully. - `REFUNDED`: The transaction was refunded in full or in part.
    - `payment_type` 'CASH' | 'POS' | 'ECOM' | 'RECURRING' | 'BITCOIN' | 'BALANCE' | 'MOTO' | 'BOLETO' | 'DIRECT_DEBIT' | 'APM' | 'UNKNOWN' — Payment type used for the transaction.
    - `installments_count` integer — Number of installments for a deferred payment.
    - `product_summary` string — Short description of the payment. The value is taken from the `description` property of the related checkout resource.
    - `payouts_total` integer — Total number of payouts to the registered user specified in the `user` property.
    - `payouts_received` integer — Number of payouts that are made to the registered user specified in the `user` property.
    - `payout_plan` 'SINGLE_PAYMENT' | 'TRUE_INSTALLMENT' | 'ACCELERATED_INSTALLMENT' — Payout plan of the registered user at the time when the transaction was made.
    - `transaction_id` string — Unique identifier of the transaction.
    - `client_transaction_id` string — Client-supplied identifier of the transaction.
    - `user` string, email — Email address of the registered user (merchant) to whom the payment is made.
    - `type` 'PAYMENT' | 'REFUND' | 'CHARGE_BACK' — Type of the transaction for the registered user specified in the `user` property.
    - `card_type` 'ALELO' | 'AMEX' | 'CONECS' | 'CUP' | 'DINERS' | 'DISCOVER' | 'EFTPOS' | 'ELO' | 'ELV' | 'GIROCARD' | 'HIPERCARD' | 'INTERAC' | 'JCB' | 'MAESTRO' | 'MASTERCARD' | 'PLUXEE' | 'SWILE' | 'TICKET' | 'VISA' | 'VISA_ELECTRON' | 'VISA_VPAY' | 'VPAY' | 'VR' | 'UNKNOWN' — Issuing card network of the payment card used for the transaction.
    - `payout_date` string, date — Payout date (if paid out at once).
    - `payout_type` 'BANK_ACCOUNT' | 'PREPAID_CARD' — Payout type.
    - `refunded_amount` number — Total refunded amount.
  - `links` TransactionsHistoryLink[] — Pagination links for navigating the transaction history.
    - `rel` string, required — Relation.
    - `href` string, required — Location.

## Other responses

- `400` — The request is invalid for the submitted query parameters.
- `401` — The request is not authorized.

## 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[]`
  - …2 more
- **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[]`
  - …6 more

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

---

[API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) · [All operations](https://skmtc.dev/sumup/apis/sumup-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sumup/sumup-rest-api/revisions/b050b86c35d1/schema)