---
title: "List transactions"
method: GET
path: "/v1/marketplaces/{marketplaceId}/merchants/{merchantId}/transactions"
tags: ["Merchant advancement transaction"]
---

# List transactions

`GET /v1/marketplaces/{marketplaceId}/merchants/{merchantId}/transactions`

## Request

- Base URL: `https://sandbox.pismolabs.io/merchants`
- URL: `https://sandbox.pismolabs.io/merchants/v1/marketplaces/{marketplaceId}/merchants/{merchantId}/transactions`
- Auth: none declared. Required headers: `Authorization`

Search for the balance of future schedules, consolidated by expected settlement date. In a head (centralizing) and branch (centralized) scenario, the transaction sum from all merchant branches is listed.

## Path parameters

- `marketplaceId` integer, required: Marketplace ID
- `merchantId` integer, required: Merchant ID

## Query parameters

- `startPaymentDate` string, date: If not sent, the default value for the start date is the next day.<br> The date format used is [ISO8601](https://en.wikipedia.org/wiki/ISO_8601). minLength: 10 maxLength: 10
- `endPaymentDate` string, date: If not sent, the default end date value is the start day plus seven days.<br> The date format used is [ISO8601](https://en.wikipedia.org/wiki/ISO_8601). minLength: 10 maxLength: 10

## Headers

- `Authorization` string, required: Authorization token

## Response `200`

OK

- MerchantTransactionsResponse
  - `currency_code` string: ISO-4217 alphabetic (3 characters) currency code.
  - `items` object[]
    - `scheduled_payment_date` string, date: Scheduling date for the next payment
    - `gross_value` number, float: Merchant consolidated gross amount
    - `discount` number, float: Merchant consolidated discount amount
    - `net_value` number, float: Merchant consolidated net value
    - `details` object[]
      - `merchant_id` integer: ID of the merchant who owns the transaction
      - `merchant_name` string: Name of the merchant who owns the transaction
      - `gross_value` number, float: Total transaction gross amount
      - `discount` number, float: Total transaction discount amount
      - `net_value` number, float: Total transaction net amount
      - `tax` object: Taxes charged to the merchant
        - `advancement_fee` number, float: Fixed fee to be applied to the advancement request
        - `discount_rate` number, float: Discount rate used to calculate the discount over merchant advancements
        - `maximum_advancement_percentage` number, float: Maximum allowable percentage of the net amount for the advancement
  - `totals` object
    - `gross_value` number, float: Total consolidated gross amount
    - `discount` number, float: Total consolidated discount amount
    - `net_value` number, float: Total consolidated net value

## Other responses

- `400`: BAD REQUEST
- `404`: Marketplace or merchant does not belong to the tenant

---

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