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

# Transfer credit

`POST /{api_key}/credit-transfers`

Transfer credit limit between a primary account and one of its subaccounts.

## Path parameters

- `api_key` string, required

## Request body

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

## Response `200`

Credit transfer response

- TransferCreditResponse
  - `amount` number — Credit transfer amount
  - `created_at` string — The date and time when the credit transfer was executed
  - `credit_transfer_id` string — Unique credit transfer ID
  - `from` string — Account the credit is transferred from
  - `reference` string — Reference for the credit transfer
  - `to` string — Account the credit 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)