---
title: "Create internal transfer"
method: POST
path: "/ledger/internal-transfers"
tags: ["ledger-transfer"]
---

# Create internal transfer

`POST /ledger/internal-transfers`

This operation allows the client to create an internal transfer between subaccounts and main account.

## Request body

- InternalTransferRequest — Internal request to transfer funds between two sub-accounts of between main account and sub-account. The accounts must have the same currency.
  - `sourceAccountId` string, uuid, required — Source account ID, could be the main account or another sub-account
  - `destinationAccountId` string, uuid, required — Destination account ID, could be the main account or another sub-account
  - `reference` string — Alpha-numeric transfer reference
  - `amount` number, required — Transfer amount
  - `notes` string — Transfer description

## Response `201`

Internal transfer created successfully

- InternalTransfer
  - `reference` string, required — Transfer reference
  - `sourceAccountId` string, uuid, required — Source account ID
  - `sourceAccountRef` string — The transaction reference on the source account.
  - `destinationAccountId` string, uuid, required — Destination account ID
  - `destinationAccountRef` string — The transaction reference on the destination account.
  - `amount` number, required — Transfer amount
  - `currency` string, required — Transfer currency
  - `status` 'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'SUCCESS', required — Status of the transaction, indicating its current state in the processing lifecycle. - PENDING: The transaction has been created but not yet processed. - IN_PROGRESS: The transaction is currently being processed. - FAILED: The transaction processing has failed. - SUCCESS: The transaction has been successfully processed.
  - `createdDate` string, date-time, required — Transfer creation date
  - `description` string — Transfer description

## Other responses

- `400` — Request could not be validated
- `401` — Client is not authorized to make request
- `403` — Expected permission is not available.
- `default` — Internal Server Error

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/revisions/35fe01ca087b/schema)