Create a wire transfer

POST

transfers

wire

curl --request POST \
  --url https://api.slash.com/v2/transfers/wire \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'x-legal-entity: <x-legal-entity>' \
  --data '
{
  "amount": {
    "amount": 1250,
    "currency": "USD"
  },
  "fromAccount": "subaccount_source123",
  "destinationId": "le_contact_destination_bank123",
  "description": "Invoice 1042"
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    'x-legal-entity': '<x-legal-entity>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: {amount: 1250, currency: 'USD'},
    fromAccount: 'subaccount_source123',
    destinationId: 'le_contact_destination_bank123',
    description: 'Invoice 1042'
  })
};

fetch('https://api.slash.com/v2/transfers/wire', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/transfers/wire"

payload = {
    "amount": {
        "amount": 1250,
        "currency": "USD"
    },
    "fromAccount": "subaccount_source123",
    "destinationId": "le_contact_destination_bank123",
    "description": "Invoice 1042"
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/transfers/wire"

	payload := strings.NewReader("{\n  \"amount\": {\n    \"amount\": 1250,\n    \"currency\": \"USD\"\n  },\n  \"fromAccount\": \"subaccount_source123\",\n  \"destinationId\": \"le_contact_destination_bank123\",\n  \"description\": \"Invoice 1042\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "transfer_intent_2rj4l7hmrrrcv",
  "accountId": "sa_group_primary123",
  "amount": {
    "amount": 123,
    "currency": "<string>"
  },
  "transactionIds": [
    "agg_tx_2rj4l7hmrrrcv"
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "type": "wire",
  "status": "pending",
  "wire": {
    "imad": "<string>",
    "omad": "<string>",
    "returnReason": "<string>"
  },
  "fromAccount": "subaccount_operations123",
  "description": "Invoice 1042",
  "statementDescriptor": "VENDOR PAYMENT",
  "submittedAt": "2023-11-07T05:31:56Z",
  "settledAt": "2023-11-07T05:31:56Z",
  "failedAt": "2023-11-07T05:31:56Z",
  "canceledAt": "2023-11-07T05:31:56Z",
  "contactId": "le_c_vendor123",
  "destinationId": "le_contact_destination_bank123"
}

Requires a source IP on the legal entity’s enabled IP allowlist.

Read Sending wires for setup, examples, and lifecycle guidance.

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

X-Idempotency-Key

string

required

Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.

Required string length: 1 - 255

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Body

application/json

Send USD to a saved US bank-account destination by domestic wire.

amount

UsdMoney · object

required

A positive USD amount expressed in cents.

Hide child attributes

amount.amount

integer

required

Amount in cents. For example, 1250 represents USD 12.50.

Required range: x >= 1

Example:

1250

amount.currency

enum<string>

required

Available options:

USD

fromAccount

string

required

Source virtual-account id with the subaccount_ prefix.

Example:

"subaccount_source123"

destinationId

string

required

Saved US bank-account destination.

Example:

"le_contact_destination_bank123"

description

string

Human-readable private transfer memo.

Example:

"Invoice 1042"

statementDescriptor

string

Optional statement text.

Response

The created wire transfer.

A domestic wire transfer.

string

required

Transfer id with the transfer_intent_ prefix.

Example:

"transfer_intent_2rj4l7hmrrrcv"

accountId

string

required

Account containing the source balance.

Example:

"sa_group_primary123"

amount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

amount.amount

integer

required

Amount in the currency's minor units.

amount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

transactionIds

string[]

required

Transaction ids produced by this transfer.

Transaction id with the agg_tx_ prefix.

createdAt

string<date-time>

required

Time the transfer was created.

type

enum<string>

required

Available options:

wire

status

enum<string>

required

Lifecycle state of a domestic or international wire transfer.

Available options:

pending,

pending_approval,

in_review,

scheduled,

canceled,

failed,

settled,

returned

wire

object

required

Hide child attributes

wire.imad

string

wire.omad

string

wire.returnReason

string

fromAccount

string

Source virtual-account id, when the transfer is scoped to one.

Example:

"subaccount_operations123"

description

string

Human-readable private transfer memo.

Example:

"Invoice 1042"

statementDescriptor

string

Statement or network descriptor supplied when the transfer was created.

Example:

"VENDOR PAYMENT"

submittedAt

string<date-time>

Time the transfer was submitted for processing.

settledAt

string<date-time>

Time the transfer settled.

failedAt

string<date-time>

Time the transfer failed.

canceledAt

string<date-time>

Time the transfer was canceled.

contactId

string

Contact receiving the transfer.

Example:

"le_c_vendor123"

destinationId

string

Saved destination used for the transfer.

Example:

"le_contact_destination_bank123"

⌘I

Create a wire transfer

curl --request POST \
  --url https://api.slash.com/v2/transfers/wire \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'x-legal-entity: <x-legal-entity>' \
  --data '
{
  "amount": {
    "amount": 1250,
    "currency": "USD"
  },
  "fromAccount": "subaccount_source123",
  "destinationId": "le_contact_destination_bank123",
  "description": "Invoice 1042"
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    'x-legal-entity': '<x-legal-entity>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: {amount: 1250, currency: 'USD'},
    fromAccount: 'subaccount_source123',
    destinationId: 'le_contact_destination_bank123',
    description: 'Invoice 1042'
  })
};

fetch('https://api.slash.com/v2/transfers/wire', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/transfers/wire"

payload = {
    "amount": {
        "amount": 1250,
        "currency": "USD"
    },
    "fromAccount": "subaccount_source123",
    "destinationId": "le_contact_destination_bank123",
    "description": "Invoice 1042"
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/transfers/wire"

	payload := strings.NewReader("{\n  \"amount\": {\n    \"amount\": 1250,\n    \"currency\": \"USD\"\n  },\n  \"fromAccount\": \"subaccount_source123\",\n  \"destinationId\": \"le_contact_destination_bank123\",\n  \"description\": \"Invoice 1042\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "transfer_intent_2rj4l7hmrrrcv",
  "accountId": "sa_group_primary123",
  "amount": {
    "amount": 123,
    "currency": "<string>"
  },
  "transactionIds": [
    "agg_tx_2rj4l7hmrrrcv"
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "type": "wire",
  "status": "pending",
  "wire": {
    "imad": "<string>",
    "omad": "<string>",
    "returnReason": "<string>"
  },
  "fromAccount": "subaccount_operations123",
  "description": "Invoice 1042",
  "statementDescriptor": "VENDOR PAYMENT",
  "submittedAt": "2023-11-07T05:31:56Z",
  "settledAt": "2023-11-07T05:31:56Z",
  "failedAt": "2023-11-07T05:31:56Z",
  "canceledAt": "2023-11-07T05:31:56Z",
  "contactId": "le_c_vendor123",
  "destinationId": "le_contact_destination_bank123"
}

Accounts

Virtual accounts

Contacts

Transfers

Transactions

Create a wire transfer

Authorizations

Headers

Body

Response