Skip to main content
POST
Transfer amount between bank accounts

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

Trio-Version
enum<string>
required

Version of the v2 contract the client is written against. Each breaking change publishes a new version.

Available options:
2026-10-19.v2
Trio-Target-Org-Id
string<uuid>

ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org.

Body

application/json

The transfer attributes

Body params to generate a transfer

amount
integer
required

Amount in cents

Required range: x >= 1
from_bank_account_id
string<uuid>
required

From bank account ID

to_bank_account_id
string<uuid>
required

To bank account ID

description
string

Transfer description

external_id
string

External ID

Response

Transfer

Transfer requested between two bank accounts. trio-spi creates the transfer document asynchronously; read it back through GET /v2/documents/transfer/{id} for its details and final state.

data
object
required