Skip to main content
POST
Create Wire Transfer

Authorizations

x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Headers

Idempotency-Key
string | null

A unique key you generate (1-50 printable ASCII characters, no spaces) so retrying this request never creates a duplicate. Reusing a key is rejected.

Required string length: 1 - 50
Pattern: ^[!-~]+$
x-entity-id
string<uuid>

Optional entity_id to scope requests to a specific entity.

Path Parameters

account_id
string
required

The ID of the account.

Body

application/json
amount
required

Amount to send, in USD.

Required range: 1 <= x <= 1000000000
counterparty_id
string<uuid>
required

Contact to pay. Use list_contacts to find one.

email
string<email> | null

Email address to notify when the operation completes

instructions
string | null

Wire instructions sent to the receiving bank.

Required string length: 1 - 140
purpose
string | null

Purpose of payment. Required by some receiving banks.

Minimum string length: 1
internal_note
string | null

Private note, visible only inside Meow.

Required string length: 5 - 255
idempotency_key
string | null
deprecated

Deprecated: send the key in the Idempotency-Key header instead. When both are sent they must match.

Required string length: 1 - 50

Response

Successful Response

status
enum<string>
required
Available options:
pending,
pending_approval,
canceled,
processing,
error,
sent,
returned,
void
amount
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
instructions
string | null
required
counterparty_id
string<uuid>
required
created_time
integer
required
transfer_type
enum<string>
required

The rail a transfer moves on, as the customer API reports it.

Available options:
book,
usdc,
usdt,
pyusd,
cash,
usdg,
ach,
wire
approval_id
string<uuid>
required
id
string | null
message
string | null