v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-2684278289.5 KB

Accounts

Create an internal transfer

Transfer funds between two accounts within the same organization. Supports transfers between depository accounts (checking/savings), from a depository account to a treasury/investment account, and from a treasury/investment account to a depository account. Creates paired debit and credit transactions.

post/transfer

Request body

amountnumber double required

A positive dollar amount with at least 1 cent.

destinationAccountIdstring uuid required

ID for a Mercury account.

idempotencyKeystring required

notestring nullable

sourceAccountIdstring uuid required

ID for a Mercury account.

Response

Example response

{
  "creditTransaction": {
    "createdAt": "2016-07-22T00:00:00Z",
    "estimatedDeliveryDate": "2016-07-22T00:00:00Z",
    "failedAt": "2016-07-22T00:00:00Z",
    "postedAt": "2016-07-22T00:00:00Z"
  },
  "debitTransaction": {
    "createdAt": "2016-07-22T00:00:00Z",
    "estimatedDeliveryDate": "2016-07-22T00:00:00Z",
    "failedAt": "2016-07-22T00:00:00Z",
    "postedAt": "2016-07-22T00:00:00Z"
  }
}