---
title: "List global payout batches"
method: GET
path: "/v1/global-payout-batches"
tags: ["Global Payout Batches"]
---

# List global payout batches

`GET /v1/global-payout-batches`

## Query parameters

- `limit` number
- `offset` number
- `page_size` number
- `starting_after` string
- `onBehalfOf` string
- `status` 'DRAFT' | 'PENDING_APPROVAL' | 'PROCESSING' | 'COMPLETED' | 'PARTIALLY_COMPLETED' | 'FAILED' | 'CANCELLED' | 'REJECTED'

## Headers

- `X-API-Key` string

## Response `200`

Global payout batches retrieved

- object
  - `data` PayoutBatchResponseDto[]
    - `id` string, required
    - `organizationId` string, required
    - `onBehalfOf` string, required
    - `source` PayoutBatchSourceResponseDto, required
      - `currency` string, required
      - `paymentRail` string, required
    - `status` 'DRAFT' | 'PENDING_APPROVAL' | 'PROCESSING' | 'COMPLETED' | 'PARTIALLY_COMPLETED' | 'FAILED' | 'CANCELLED' | 'REJECTED', required
    - `paymentReason` 'CAPITAL_CONTRIBUTIONS' | 'CHARITABLE_CONTRIBUTIONS' | 'CONSULTING_FEES' | 'CORPORATE_TAX_PAYMENTS' | 'DOWN_PAYMENTS_FOR_REAL_ESTATE' | 'EDUCATION_FEES' | 'EMPLOYEE_SALARIES_OR_WAGES' | 'EXPENSES_REIMBURSEMENT' | 'GIFTS' | 'GOVERNMENT_GRANTS' | 'INCOME_TAX_PAYMENTS' | 'INHERITANCE_PAYMENTS' | 'INSURANCE_CLAIM_PAYOUTS' | 'INSURANCE_PREMIUM_PAYMENTS' | 'INVESTMENTS' | 'LOAN_ADVANCES' | 'MORTGAGE_PAYMENTS' | 'OTHER' | 'PAYMENT_FOR_GOODS_AND_SERVICES' | 'PERSONAL_TRANSFERS' | 'REAL_ESTATE_PURCHASES' | 'REMITTANCES' | 'RENT' | 'REPAYMENT_OF_LOANS' | 'ROYALTIES' | 'SELF' | 'TRADE_SETTLEMENT' | 'TRUST_FUND_DISTRIBUTIONS' | 'UTILITY_BILLS' | 'WELFARE_OR_BENEFITS' | 'WINNINGS_AND_PRIZES', required
    - `items` PayoutBatchItemResponseDto[], required
      - `id` string, required
      - `position` number, required — 0-based position within the batch
      - `amount` MoneyOutputDto, required
        - `currency` string, required — Currency code
        - `exponent` number, required — Number of decimal places for this currency (e.g., 2 for USD, 6 for USDC)
        - `value` string, required — Amount in smallest unit as a string
        - `displayValue` string, required — Human-readable decimal value
      - `counterpartyId` string, required
      - `destination` PayoutBatchItemDestinationResponseDto, required
        - `type` 'EXTERNAL_WALLET', required
        - `currency` string, required
        - `paymentRail` string, required
        - `accountId` string, required — Public destination account ID.
        - `address` string, required — Destination wallet address snapshot from batch creation.
      - `transferId` string, nullable — Child transfer ID once created after approval.
      - `status` 'PENDING' | 'TRANSFER_CREATED' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
      - `clientReferenceId` string, nullable
      - `developerFeeFixed` number, nullable — Fixed developer fee in minor units.
      - `developerFeePercent` number, nullable — Developer fee as decimal percentage.
      - `errorMessage` string, nullable — Customer-safe error when item creation or settlement failed.
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `rejectionReason` string, nullable — Reason when the batch was rejected during review.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `total` number
  - `limit` number
  - `offset` number

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials

---

[API](https://skmtc.dev/infinite/apis/infinite-api.md) · [All operations](https://skmtc.dev/infinite/apis/infinite-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infinite/infinite-api/revisions/bca54100a637/schema)