---
title: "List merchant transactions (V3)"
method: GET
path: "/v3/merchants/{merchantId}/transactions"
tags: ["Merchant transaction"]
---

# List merchant transactions (V3)

`GET /v3/merchants/{merchantId}/transactions`

## Request

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

List merchant transactions filtered using query parameters.

## Path parameters

- `merchantId` integer, required

## Query parameters

- `marketplaceId` integer
- `status` 'PENDING' | 'SCHEDULED' | 'BLOCKED' | 'SETTLED' | 'PAID' | 'ADVANCED' | 'CANCELED' | 'RETURNED'
- `startPaymentDate` string, date
- `endPaymentDate` string, date
- `startEventDate` string, date
- `endEventDate` string, date
- `startReceiptDate` string, date
- `endReceiptDate` string, date
- `orgOperationId` integer
- `sortBy` string
- `meta` string
- `page` integer
- `perPage` integer

## Headers

- `Content-Type` string
- `Authorization` string

## Response `200`

OK

- GETTransactionsV3Response
  - `total_items` integer: Total number of items
  - `per_page` integer: Number of items per page
  - `pages` integer: Number of pages
  - `current_page` integer: Current page number
  - `tax` RelatedFees: The related fees available to operation
    - `mdr` object[]: Array of fees
      - `description` string: Operation type description
      - `mdr` number, float: Merchant discount rate (MDR)
      - `days_to_payment` integer: Number of days before the first payment
  - `items` object[]: Merchants transactions
    - `id` integer: Merchant transaction ID
    - `type` string: Transaction type
    - `number_of_installments` integer: Number of installments
    - `installment` integer: Installment number of transaction
    - `gross_value` number, float: Gross amount
    - `net_value` number, float: Net amount
    - `discount` number, float: Discount amount
    - `operation_type` integer: Operation type ID
    - `operation` string: Operation name
    - `event_date` string, datetime: The transaction event date and time (sale or refund). UTC date/time - format: yyyy-MM-ddThh:mm:ssZ
    - `payment_date` string, date: Scheduled payment date. Format = yyyy-mm-dd.
    - `receipt_date` string, date: Date of merchant transaction settlement. Format = yyyy-mm-dd.
    - `received_value` number, float: Transaction amount settled
    - `status` 'PENDING' | 'SCHEDULED' | 'BLOCKED' | 'SETTLED' | 'PAID' | 'ADVANCED' | 'CANCELED' | 'RETURNED' | 'WAITING_SPLIT' | 'SPLITTED': Merchant transaction status
    - `meta` object[]: Metadata. The accepted parameters are `MarketplaceAuthorization` and `MarketplaceTransaction`.
      - `name` string
      - `value` string

## Other responses

- `400`: Bad Request
- `401`: Access token is missing or invalid
- `404`: The specified resource was not found
- `408`: Request timeout
- `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)