---
title: "Turnover (sum) of all transactions"
method: POST
path: "/public/transactionTurnover"
tags: ["Merchant Portal services API"]
---

# Turnover (sum) of all transactions

`POST /public/transactionTurnover`

## Request

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

Returns sum (Debit - Credit) of transactions by given dates (from-to).<br>

Required role for operation: MP_CORPORATE or TE_MERCHANT_TERMINAL_MANAGEMENT.<br>
Create MPauditlog record with event type : DashboardTransactionTurnover (12).<br>

Supports authentication with the following types of tokens:
- Bearer <token>, which is a Bearer token authentication. The bearer token is a cryptic string, usually generated by the server in response to a login request.

Returns periods: HOUR, DAY, MONTH, YEAR<br>
Period is computed by the following criteria:<br>
- If days between date (from-to) <= 1, returns period HOUR and sum of transactions by hours 
- If days between date (from-to) <= 31, returns period DAY and sum of transactions by days, datePart in format yyyy-MM-dd
- If days between date (from-to) <= 365, returns period MONTH and sum of transactions by months, datePart in format yyyy-MM
- Otherwise returns period YEAR and sum of transactions by years

## Request body

- TransactionTurnoverRequest
  - `transactionDateFrom` string, date-time, required
  - `transactionDateTo` string, date-time, required
  - `period` string

## Response `200`

Successful operation

- TransactionsTurnoverResponse
  - `responseCode` integer
  - `responseMessage` string
  - `transactionDateFrom` string, date-time
  - `transactionDateTo` string, date-time
  - `period` string
  - `turnovers` TurnoverPerCurrency[]
    - `currency` string
    - `turnover` Turnover[]
      - `amount` integer
      - `datePart` string

## Other responses

- `400`: Bad request
- `401`: Unauthenticated - Authentication failed
- `403`: Unauthorized - Missing role TE_MERCHANT_TERMINAL_MANAGEMENT or MP_CORPORATE
- `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/transactionTurnover/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)