---
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`

## Request

- Base URL: `https://core.quidkey.com`
- URL: `https://core.quidkey.com/api/v1/merchants/{merchantId}/payouts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/merchants/:merchantId/payouts/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-06-17** `b372e7d5563d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/merchants/:merchantId/payouts/get.md)

---

[API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [All operations](https://skmtc.dev/banqzinc/apis/quidkey-api/llms.txt) - [OpenAPI document](https://skmtc.dev/banqzinc/apis/quidkey-api/revisions/f86d2bdbcb08?raw)