Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Bank accounts

Register IBAN account

Register a new International Bank Account Number (IBAN) bank account.

IBAN is a standardized international system developed to identify bank accounts when making international transactions. For more information, refer to <a href="https://www.investopedia.com/terms/i/iban.asp" target="_blank"> What Is an International Bank Account Number (IBAN) and How Does It Work</a>.

To read about Pismo's banking offerings, see Banking overview.

This endpoint generates a <a href="https://developers.pismo.io/events/docs/intl-bankaccounts-intl-bankaccount-register-1">Bank account registered</a> event.

post/v2/accounts/{accountId}/bank-accounts/iban

Path parameters

accountIdstring required

Pismo account ID

Headers

Authorizationstring required

Account token - token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message

Request body

metadataMetadata

A set of key-value pairs used to store custom data or additional information.<br>

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Example request

{
  "scheme": {
    "iban": "GB29NWBK60161331926819"
  }
}

Response

Response body

account_idinteger

Account ID

creation_datetimestring date-time

Account creation date time displayed in ISO 8601 format 2023-04-12T23:20:50.52Z.

metadataMetadata

A set of key-value pairs used to store custom data or additional information.<br>

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Example response

{
  "account_id": 78123456,
  "creation_datetime": "2023-04-12T23:20:50.52Z",
  "scheme": {
    "iban": "GB29NWBK60161331926819"
  }
}