---
title: "Transfer balance"
method: POST
path: "/{api_key}/balance-transfers"
tags: ["Transfers"]
---

# Transfer balance

`POST /{api_key}/balance-transfers`

Transfer balance between a primary account and one of its subaccounts. Note that balance_available_for_transfer = |account_balance - credit_limit| of the source account.

## Path parameters

- `api_key` string, required

## Request body

- TransferBalanceOrCreditRequest
  - `amount` number, required
  - `from` string, required
  - `reference` string
  - `to` string, required

## Response `200`

Balance transfer response

- TransferBalanceResponse
  - `amount` number — Balance transfer amount
  - `balance_transfer_id` string — Unique balance transfer ID
  - `created_at` string — The date and time when the balance transfer was executed
  - `from` string — Account the balance is transferred from
  - `reference` string — Reference for the balance transfer
  - `to` string — Account the balance is transferred to

## Other responses

- `401` — Credential is missing or invalid
- `403` — Action is forbidden
- `404` — The account ID provided does not exist in our system or you do not have access
- `422` — Validation Error

---

[API](https://skmtc.net/vonage/apis/subaccounts.md) · [All operations](https://skmtc.net/vonage/apis/subaccounts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vonage/subaccounts/versions/48b589cc0b41/schema)