Slash API: Move Funds Between Accounts

Overview

Slash's API allows you to automate internal fund movements between accounts in your organization. All transfers are near-instant and don't incur any fees.

Prerequisites

• An API key with appropriate permissions
• At least two accounts (primary plus one or more virtual accounts)
• Sufficient balance in the source account

Account Structure

• Primary account — Your main Slash account. In API responses, this is a virtual account with accountType: "primary".
• Virtual accounts — Sub-accounts under your primary account (accountType: "default"), each with its own balance and account number.

How to Transfer Funds

Step 1: List Your Virtual Accounts

Use GET /virtual-account to see all your virtual accounts. You can filter by parent account with ?filter:accountId={accountId}.

Step 2: Check Account Balances

Before transferring, verify the source account has enough funds with GET /account/{accountId}/balance.

Step 3: Initiate the Transfer

Send a POST request to /transfer/virtual-account with the following:

• source — The virtual account ID to transfer from
• destination — The virtual account ID to transfer to
• amountCents — The amount to transfer in cents
• memo (optional) — A description for the transfer, up to 255 characters

You must include an X-Idempotency-Key header with a unique value. This ensures that if your request is retried (e.g., due to a network timeout), the transfer is only executed once.

Step 4: Confirm the Transfer

A successful response returns a transferId. You can verify the transfer went through by checking account balances or listing recent transactions.

Common Use Cases

• Funding a virtual account from your primary account
• Moving funds between virtual accounts
• Withdrawing from a virtual account back to your primary account

Error Handling

• 401 Unauthorized — Your API key is invalid or missing
• 403 Forbidden — Your API key doesn't have the required permissions
• 429 Too Many Requests — You've hit the rate limit. Wait and retry.

For transient errors, implement retry logic with exponential backoff.

Need More Help?

For the full API reference, visit https://api.joinslash.com/openapi. Contact support at support@slash.com or reach out via the in-app chat.