---
title: "Get transactions summary [beta]"
method: GET
path: "/v2/merchants/{merchantId}/transactions-totals"
tags: ["Merchant transaction"]
---

# Get transactions summary \[beta\]

`GET /v2/merchants/{merchantId}/transactions-totals`

## Request

- Base URL: `https://sandbox.pismolabs.io/merchants`
- URL: `https://sandbox.pismolabs.io/merchants/v2/merchants/{merchantId}/transactions-totals`
- Auth: HTTP bearer

Returns the transactions totals summarized by status and/or date.
When the `groupBy` is provided with the values `date` or `dateAndStatus` the date range between `startPaymentDate` and `endPaymentDate` must not exceed 30 days.

## Path parameters

- `merchantId` integer, required

## Query parameters

- `startPaymentDate` string, date, required
- `endPaymentDate` string, date, required
- `marketplaceId` integer
- `status` string
- `groupBy` 'status' | 'date' | 'dateAndStatus'

## Headers

- `Authorization` string

## Response `200`

OK

- GETTransactionsTotalsV2Response
  - `items` object[]
    - `gross_amount` string, float: Gross amount
    - `discount_amount` string, float: Discount amount
    - `net_amount` string, float: Net amount (Gross amount - Discount amount)
    - `status` string: Transactions status. Returned only if the `groupBy` filter is `status` or `dateAndStatus`
    - `scheduled_payment_date` string, date: Transactions scheduled payment date. Returned only if the `groupBy` filter is `date` or `dateAndStatus`. Format = yyyy-mm-dd.
  - `totals` TransactionTotalAmountV2
    - `gross_amount` string, float: Gross amount
    - `discount_amount` string, float: Discount amount
    - `net_amount` string, float: Net amount (Gross amount - Discount amount)

## Other responses

- `400`: Bad Request
- `401`: Access token is missing or invalid
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/seller-management-merchants.md) - [All operations](https://skmtc.dev/pismo/apis/seller-management-merchants/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/seller-management-merchants/revisions/f0c2e31fbbc0?raw)
