---
title: "Get a global payout batch"
method: GET
path: "/v1/global-payout-batches/{id}"
tags: ["Global Payout Batches"]
---

# Get a global payout batch

`GET /v1/global-payout-batches/{id}`

## Path parameters

- `id` string, required

## Headers

- `X-API-Key` string

## Response `200`

Global payout batch retrieved

- 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

## 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/5426f2706725/schema)