---
title: "Transfer balance to customer"
method: POST
path: "/api/v1/partner/accounts/{customer_auth_id}/transfer-balance"
tags: ["Partner API"]
---

# Transfer balance to customer

`POST /api/v1/partner/accounts/{customer_auth_id}/transfer-balance`

## Request

- Base URL: `https://api.vobiz.ai`
- URL: `https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/transfer-balance`
- Auth: API key in header `X-Auth-ID` and API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/vobiz/apis/vobiz-api/docs/api/v1/partner/accounts/:customer_auth_id/transfer-balance/post.ts> (a function with typed inputs; its response is checked against the schema)

Atomically debits your partner master balance and credits the customer's
wallet. Both legs are recorded in each account's ledger. Transfers are
**permanent and cannot be reversed.**

## Path parameters

- `customer_auth_id` string, required

## Request body

- object
  - `amount` number, required: Positive decimal. Your master balance must be ≥ this amount.
  - `currency` string, required: Must match your partner account currency.
  - `description` string: Note for your records. Appears in both ledgers.

## Response `200`

Transfer completed

## Other responses

- `400`: Insufficient partner balance

---

[API](https://skmtc.dev/vobiz/apis/vobiz-api.md) - [All operations](https://skmtc.dev/vobiz/apis/vobiz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vobiz/apis/vobiz-api/revisions/863f08cd6737?raw)