POST/api/v2/banking/transfers/internal

Execute an internal transfer between balances for a specific user within the authenticated company.

Authentication

Send your API key in the x-api-key header on every request.

Request body

application/json

Request body fields
Field	Type	Required
UserId	unknown	Yes
SourceBalanceId	string	Yes
DestinationBalanceId	string	Yes
Amount	unknown	Yes
Currency	string	Yes
Reference	string	No

Responses

201 — Created

Response 201 fields
Field	Type	Required	Description
Success	boolean	No
TransferId	string	No
Status	string	No
Amount	unknown	No
Currency	string	No
Provider	BankProvider	No	Indicates which banking provider owns a resource
CreatedAt	string (date-time)	No
ErrorMessage	string	No

400 — Bad Request

Response 400 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

401 — Unauthorized

Response 401 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

404 — Not Found

Response 404 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

500 — Internal Server Error

Response 500 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

Example request

curl -X POST "https://{base_url}/api/v2/banking/transfers/internal" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"UserId":"…","SourceBalanceId":"…","DestinationBalanceId":"…","Amount":"…"}'

This page is generated from the live OpenAPI specification and always matches the current API.