POST /api/v1/accountissuance/accounts.404.iban, accountNumber, swiftRouteBICNumber, routingCode, bankName) may be null while the account is still pending.GET /api/v1/accountissuance/{accountId}/status endpoint for polling.| Status | Meaning |
|---|---|
Pending | Being provisioned |
Approved | Done — banking details available |
Rejected | Issuance failed |
| Field | Type | Nullable | Description |
|---|---|---|---|
data.accountId | string (uuid) | No | Account ID |
data.productId | string (uuid) | No | Product the account was issued against |
data.customerId | string (uuid) | No | Owning customer |
data.currency | string | No | ISO-4217 currency code |
data.state | string | No | Pending | Approved | Rejected |
data.accountNumber | string | Yes | Local account number |
data.iban | string | Yes | IBAN, where applicable |
data.swiftRouteBICNumber | string | Yes | SWIFT/BIC code of the partner bank |
data.accountHolderName | string | No | Name of the account holder |
data.bankName | string | Yes | Partner bank holding the account |
data.routingCode | string | Yes | Routing code (e.g. ABA number) |
data.routingType | string | Yes | Routing code type (e.g. ABA) |
data.sortCode | string | Yes | UK sort code, if applicable |
data.minLimit | number | No | Minimum transaction limit |
data.maxLimit | number | No | Maximum transaction limit |
data.banksDetails | object | Yes | Partner bank address (Address Line1, City, State, Postal Code, Country) |
curl --location '/baseurl/api/v1/accountissuance/account/8e5f183f-545e-4c96-9876-e0c90d3fd2d5' \
--header 'X-API-Key: ak_live_8f3a9b2c1d4e5f6a7b8c' \
--header 'X-Signature: q2h8Zx0kPz5mVw7Yb3Nc1Rt6Ue9Ia4Od2Sf8Gk0Jl4=' \
--header 'X-Timestamp: 1754812800' \
--header 'X-Nonce: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
--header 'X-Body-Hash: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU='{
"accountId": "8e5f183f-545e-4c96-9876-e0c90d3fd2d5",
"productId": "b0d056de-f0d5-43c5-85c2-840810af208b",
"customerId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"currency": "USD",
"state": "Approved",
"accountNumber": "9880050634723967898",
"iban": "9880050634723967898",
"swiftRouteBICNumber": "SSBAUS32",
"accountHolderName": "Hanako Sato",
"bankName": "Slovak Savings Bank",
"routingCode": "043087080",
"routingType": "ABA",
"sortCode": null,
"minLimit": 0,
"maxLimit": 0,
"banksDetails": {
"Address Line1": "8700 Perry Highway",
"City": "Pittsburgh",
"State": "PA",
"Postal Code": "15237",
"Country": "US"
}
}