---
title: "List payout batches for the authenticated merchant"
method: GET
path: "/api/v1/merchants/{merchantId}/payouts"
tags: ["Payout"]
---

# List payout batches for the authenticated merchant

`GET /api/v1/merchants/{merchantId}/payouts`

List payout batches for the authenticated merchant

## Path parameters

- `merchantId` string, uuid, required — The unique identifier of the merchant

## Query parameters

- `status` union — Status of the payout batch
  - 'pending'
  - 'processing'
  - 'completed'
  - 'failed'

## Response `200`

Success

- PayoutMerchantBatchListResponse — Response containing a list of merchant-facing payout batches
  - `success` boolean, required — Indicates if the request was successful
  - `data` object[], required
    - `id` string, uuid, required — Unique identifier for the payout batch
    - `payment_reference` string, required — Short payment reference code for the payout batch
    - `status` union, required — Status of the payout batch
      - 'pending'
      - 'processing'
      - 'completed'
      - 'failed'
    - `currency` string, required — Currency of the payout
    - `gross_amount` string, required — Total transaction amount before fees, in the payout currency
    - `fees_total` string, required — Total fees deducted, in the payout currency
    - `net_amount` string, required — Net amount after fees (gross_amount - fees_total), in the payout currency
    - `transaction_count` number, required — Number of transactions included in this payout
    - `payout_amount` string — Amount transferred to the settlement account
    - `retained_amount` string — Amount retained for the refund account
    - `retention_rate` string — Retention rate applied (e.g. 0.1000 for 10%)
    - `executed_at` string, date-time — When the payout was executed
    - `created_at` string, date-time, required — When the payout batch was created

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)