---
title: "Get details of a payout batch for the authenticated merchant"
method: GET
path: "/api/v1/merchants/{merchantId}/payouts/{payoutBatchId}"
tags: ["Payout"]
---

# Get details of a payout batch for the authenticated merchant

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

Get details of a payout batch for the authenticated merchant

## Path parameters

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

## Response `200`

Success

- PayoutMerchantBatchResponse — Response containing a single merchant-facing payout batch
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required — A payout batch as visible to the merchant (excludes internal fields)
    - `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
- `404` — Not Found

---

[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)