Get an account IBAN
GET
/managed_accounts/{id}/iban Fetches the IBAN and bank account details of the managed account identified by the id path
parameter.
Use this to poll after adding an IBAN, and to read back the details to display for incoming deposits.
Check state before using the response. UNALLOCATED means no IBAN has been assigned yet,
PENDING_ALLOCATION means allocation is still in progress and the details aren't usable, and
ALLOCATED means they are ready to share.
bankAccountDetails is a list because a payment model can support more than one IBAN provider. Where
several sets are returned, each is a valid route for depositing into the same account.
Request
Available on
SandboxProduction
Path parameters
Responses
200OK
Success
Headers
Body
application/json
ManagedAccountIBANManagedAccountIBAN · object · 2 fields
Response example
{ "state": "UNALLOCATED", "bankAccountDetails": [ { "beneficiaryNameAndSurname": "Alex Smith", "beneficiaryBank": "National Westminster Bank PLC", "beneficiaryBankAddress": "250 Bishopsgate, London EC2M 4AA", "paymentReference": "WVR-123456789", "details": { "iban": "GB29NWBK60161331926819", "bankIdentifierCode": "NWBKGB2L" } } ]}