---
title: "Transaction History for MCOM"
method: POST
path: "/public/mcom/transactionHistory"
tags: ["MCOM services API"]
---

# Transaction History for MCOM

`POST /public/mcom/transactionHistory`

## Request

- Base URL: `https://test.tecs.at/merchantservices`
- URL: `https://test.tecs.at/merchantservices/public/mcom/transactionHistory`
- Auth: HTTP bearer

Search for transactions by given parameters<br>
Required role for operation: MCOM_WEBAPP_TX_HISTORY<br>
Create MPauditlog table record with event type : TransactionHistoryMcom (19).<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

- TransactionHistoryMcomRequest
  - `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
  - `paymentTokenPublicId` string

## Response `200`

Successful operation

- TransactionHistoryMcomResponse
  - `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: MCOM_WEBAPP_TX_HISTORY or BO_TE_TRANSACTION_HISTORY
- `500`: Internal server error

## Changes

- **2026-11-03** `6e0e5a5a2b2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluefin-com/apis/merchant-services/changes/public/mcom/transactionHistory/post.md)

---

[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.dev/bluefin-com/apis/merchant-services/revisions/6e0e5a5a2b2f?raw)