---
title: "Payout available balances"
method: POST
path: "/api/service/beneficiary-payout/create"
tags: ["Payout", "Beneficiary Payout"]
---

# Payout available balances

`POST /api/service/beneficiary-payout/create`

Payout all available balances of your account to the preconfigured beneficiary bank account or wallet. If you want to handle payouts in a more dynamic and granular way, please use the POST /payout/create endpoint.

## Headers

- `Idempotency-Key` string

## Response `200`

Succeeded Beneficiary Payouts of available balances

- object[] — Array of Beneficiary Payouts
  - `id` string, required — The unique identifier of the beneficiary payout
  - `type` 'merchant' | 'customer', required — The type of payout
  - `referenceId` string, required — The reference identifier for the payout
  - `merchant` string, required — The merchant identifier
  - `amount` number, required — The beneficiary payout amount
  - `description` string, required — Description of the payout
  - `statementDescriptor` string, required — The descriptor that appears on bank statements
  - `status` 'paid' | 'pending' | 'in_transit' | 'failed' | 'canceled', required — The current status of the payout
  - `currency` 'EUR' | 'USD' | 'GBP' | 'PLN' | 'SEK' | 'DKK', required — The currency of the balance which was settled to the beneficiary bank account or wallet.
  - `createdAt` unknown, required

---

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