---
title: "Create an asynchronous Internal Transfer"
method: POST
path: "/v1/internal_transfer"
tags: ["Internal Transfer"]
---

# Create an asynchronous Internal Transfer

`POST /v1/internal_transfer`

Creates an asynchronous Internal Transfer.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `amount` integer, required — The amount of the internal transfer transaction in cents.
  - `currency_code` 'USD', required — A three-letter currency code as defined in ISO 4217.
  - `sender_account_number_id` string, required — The ID of the Lead Bank Account Number object.
  - `receiver_account_number_id` string, required — The ID of the Lead Bank Account Number object.
  - `description` string, required — Statement descriptor for the Internal Transfer
  - `metadata` Metadata — A set of key-value pairs that can be used to store additional information related to this object.

## Response `200`

Successful response

- InternalTransferV1
  - `id` string, required — The ID of the Internal Transfer object.
  - `amount` integer, required — The amount of the transaction in cents.
  - `currency_code` 'USD', required — A three-letter currency code as defined in ISO 4217.
  - `sender_account_id` string, required — The ID of the Account object.
  - `sender_account_number_id` string, required — The ID of the Lead Bank Account Number object.
  - `receiver_account_id` string, required — The ID of the Account object.
  - `receiver_account_number_id` string, required — The ID of the Lead Bank Account Number object.
  - `status` 'processing' | 'posted' | 'rejected', required — The current status of the InternalTransfer object.
  - `description` string, required — Memo string for the transfer
  - `rejection` InternalTransferRejectionReason
    - `reason` 'account_number_not_active' | 'beneficiary_account_number_unrecognized' | 'non_sufficient_funds' | 'ofac_rejection' | 'internal_error' — The rejection code that indicates the type of rejection
    - `details` string — Additional info about the rejection
  - `metadata` Metadata, required — A set of key-value pairs that can be used to store additional information related to this object.
  - `created_at` string, date-time, required — The RFC3339 timestamp at which the InternalTransfer object was created.
  - `updated_at` string, date-time, required — The RFC3339 timestamp at which the InternalTransfer object was last updated.

## Other responses

- `400` — We couldn't parse your request body, please check that your request body is valid JSON.
- `422` — Your request parameters did not validate.

---

[API](https://skmtc.net/lead/apis/lead-bank.md) · [All operations](https://skmtc.net/lead/apis/lead-bank/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lead/lead-bank/revisions/25c2a92d55e2/schema)