---
title: "Transaction History"
method: POST
path: "/public/transactionHistory"
tags: ["Merchant Portal services API"]
---

# Transaction History

`POST /public/transactionHistory`

Search for transactions by given parameters<br>
Required role for operation: MP_CORPORATE or BO_TE_TRANSACTION_HISTORY.<br>
When user has role MP_CORPORATE, then all terminalIds are taken from UserProfile, otherwise terminalIds are taken from TecsCompany2TecsTerm entity.<br>
Create MPauditlog table record with event type : TransactionHistory.<br>
Supports filtering by wallet type: APAY (Apple Pay), GPAY (Google Pay), GPAY3D (Google Pay 3D Secure).<br>
Supports authentication with the following types of tokens:<br>
* <b>Bearer</b> &lt;token&gt;, which is a Bearer token authentication. The bearer token is a cryptic string, usually generated by the server in response to a login request.

## Request body

- TransactionHistoryRequest
  - `transactionId` string
  - `referencedTransactionId` string
  - `terminalId` integer
  - `sourceId` integer
  - `transactionType` string
  - `transactionAmountFrom` string
  - `transactionAmountTo` string
  - `clearingAmountFrom` string
  - `clearingAmountTo` string
  - `clearingCurrency` string
  - `transactionDateFrom` string, date-time
  - `transactionDateTo` string, date-time
  - `authorizationCode` string
  - `tecsengineResponseCodeFrom` string
  - `tecsengineResponseCodeTo` string
  - `receiptNumber` string
  - `retrievalReferenceNumber` string
  - `traceNumber` string
  - `clearingStatus` string
  - `cardBrand` string
  - `pagination` PaginationRequest
    - `page` integer
    - `size` integer
  - `corporateUUID` string
  - `orderByTransactionDate` string
  - `wallet` 'APAY' | 'GPAY' | 'GPAY3D' — Filter by wallet type. Allowed values: APAY, GPAY, GPAY3D
  - `3DSecure` string

## Response `200`

Successful operation

- TransactionHistoryResponse
  - `responseCode` integer
  - `responseMessage` string
  - `pagination` PaginationResponse
    - `page` integer
    - `size` integer
    - `totalElements` integer
    - `totalPages` integer
  - `transactionHistories` TransactionHistory[]
    - `transactionId` string
    - `transactionType` string
    - `terminalId` integer
    - `transactionDate` string, date-time
    - `authorizationCode` string
    - `tecsengineResponseCode` integer
    - `tecsengineResponseText` string
    - `responseCodeFromAS` string
    - `receiptNumber` string
    - `cardNumber` string
    - `cardExpiration` string
    - `cardBrand` string
    - `retrievalReferenceNumber` string
    - `traceNumber` integer
    - `transactionSource` string
    - `cardEntry` string
    - `clearingStatus` string
    - `clearingAmount` integer
    - `clearingCurrency` string
    - `transactionAmount` integer
    - `transactionCurrency` string
    - `merchantNumber` string
    - `corporateName` string
    - `clientId` integer
    - `paymentReason` string
    - `dateTimeCreate` string, date-time
    - `seqNo` integer
    - `requestIssuerDate` string, date-time
    - `responseIssuerDate` string, date-time
    - `paymentTokenPublicId` string

## Other responses

- `400` — * Invalid combination of transactionId and referencedTransactionId parameters * ReferencedTransactionId is set and TerminalId not set * ReferencedTransactionId not set and TransactionDateFrom not set * ReferencedTransactionId not set and TransactionDateTo parameters not set * Mandator not found * Invalid TerminalId
- `401` — Unauthorized - Authentication failed:<br> * MandatorId does not march * Inactive user
- `403` — Forbidden - Missing role: MP_CORPORATE or BO_TE_TRANSACTION_HISTORY
- `500` — Internal server error

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-services.md) · [All operations](https://skmtc.dev/bluefin-com/apis/merchant-services/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluefin-com/merchant-services/revisions/84e973bef72c/schema)