Skip to main content
POST
/
v1
/
businessAccount
/
banks
/
wires
Create a wire bank account
curl --request POST \
  --url https://api-sandbox.circle.com/v1/businessAccount/banks/wires \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotencyKey": "ba943ff1-ca16-49b2-ba55-1057e70ca5c7",
  "accountNumber": "12340010",
  "routingNumber": "121000248",
  "billingDetails": {
    "name": "Satoshi Nakamoto",
    "city": "Boston",
    "country": "US",
    "line1": "100 Money Street",
    "postalCode": "01234",
    "line2": "Suite 1",
    "district": "MA"
  },
  "bankAddress": {
    "country": "US",
    "bankName": "SAN FRANCISCO",
    "city": "SAN FRANCISCO",
    "line1": "100 Money Street",
    "line2": "Suite 1",
    "district": "CA"
  }
}
'
{
  "data": {
    "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
    "type": "wire",
    "status": "pending",
    "description": "WELLS FARGO BANK, NA ****0010",
    "trackingRef": "CIR13FB13A",
    "transferTypesInfo": {
      "wire": {
        "currencies": [
          "USD",
          "EUR"
        ]
      },
      "rtgs": {
        "currencies": [
          "USD"
        ]
      }
    },
    "fingerprint": "eb170539-9e1c-4e92-bf4f-1d09534fdca2",
    "billingDetails": {
      "name": "Satoshi Nakamoto",
      "city": "Boston",
      "country": "US",
      "line1": "100 Money Street",
      "line2": "Suite 1",
      "district": "MA",
      "postalCode": "01234"
    },
    "bankAddress": {
      "bankName": "SAN FRANCISCO",
      "city": "SAN FRANCISCO",
      "country": "US",
      "line1": "100 Money Street",
      "line2": "Suite 1",
      "district": "CA"
    },
    "createDate": "2020-04-10T02:13:30.000Z",
    "updateDate": "2020-04-10T02:13:30.000Z",
    "virtualAccountEnabled": false
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.circle.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Relevant fields for U.S. bank accounts.

​
idempotencyKey
string<uuid>
required

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.

Example:

"ba943ff1-ca16-49b2-ba55-1057e70ca5c7"

​
accountNumber
string
required

Account number that identifies the bank account.

Required string length: 6 - 35
Example:

"12340010"

​
routingNumber
string
required

ABA routing number for the bank account. Note this has to be specific for bank wire transfers.

Example:

"121000248"

​
billingDetails
object
required
​
bankAddress
object
required

The address details for the bank, as provided during bank account creation.

Response

Successfully created a bank account for wire transfers.

​
data
object