Create a bank account

POST /bankaccounts

Create a new bank account record with specified details including account number, BIC, type, name, owner details, and optional initial balance information.

Headers

application/json

Body Required

Request model for creating a new bank account

  • number string Required

    The account number of the bank account.

  • bic string Required

    The Business Identifier Codes (BIC) for the bank that manages the bank account.

  • type string Required

    The type of the bank account, which is one of the following:

    • bban: Basic Bank Account Number is a country-specific bank account number format.
    • iban: International Bank Account Number format.

    Values are bban or iban.

  • name string Required

    A user-defined name of the bank account, as it is shown in 24SevenOffice.

  • owner object Required

    Details for the bank account owner.

    Hide owner attributes Show owner attributes object
    • name string Required

      The company name of the bank account owner.

    • organizationNumber string Required

      The organization number of the bank account owner.

    • contact object Required

      Details for the contact person for the bank account owner.

      Hide contact attributes Show contact attributes object
      • name string Required

        The name of the contact person.

      • email string(email) Required

        The email of the contact person.

Responses

  • 201 application/json

    Created

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object

    Response model for a bank account

    • id string(uuid) Required

      A unique identifier for the bank account within 24SevenOffice.

    • number string Required

      The account number of the bank account.

    • bic string Required

      The Business Identifier Codes (BIC) for the bank that manages the bank account.

    • type string Required

      The type of the bank account, which is one of the following:

      • bban: Basic Bank Account Number is a country-specific bank account number format.
      • iban: International Bank Account Number format.

      Values are bban or iban.

    • name string Required

      A user-defined name of the bank account, as it is shown in 24SevenOffice.

    • owner object Required

      Details for the bank account owner.

      Hide owner attributes Show owner attributes object
      • name string Required

        The company name of the bank account owner.

      • organizationNumber string Required

        The organization number of the bank account owner.

      • contact object Required

        Details for the contact person for the bank account owner.

        Hide contact attributes Show contact attributes object
        • name string Required

          The name of the contact person.

        • email string(email) Required

          The email of the contact person.

    • balance object

      The balance of the bank account. The whole balance object is omitted if no balance is available.

      Hide balance attributes Show balance attributes object
      • amount number

        The amount of the balance.

      • timestamp string(date-time)

        The timestamp of the balance.

      • currency object

        The currency of the balance.

        Hide currency attribute Show currency attribute object
        • code string Required

          The currency code of the balance.

    • createdAt string(date-time) Required

      A timestamp for when a record was created, in ISO 8601 format.

    • modifiedAt string(date-time) Required

      A timestamp for when one of the properties of a record was last modified, in ISO 8601 format. The Bank Account Balance changes are not included here, as these are defined by a separate "timestamp" property for the balance object.

POST /bankaccounts
curl \
 -X POST https://rest.api.24sevenoffice.com/v1/bankaccounts \
 -H "Content-Type: application/json" \
 -H "Authorization: string" \
 -d '{"number":"90000000001","bic":"DNBANOKKXXX","type":"bban","name":"ABC bank account","owner":{"name":"ABC Corporation","organizationNumber":"123456789","contact":{"name":"John Doe","email":"doe@example.com"}}}'
Request examples
# Headers
Authorization: string

# Payload
{
  "number": "90000000001",
  "bic": "DNBANOKKXXX",
  "type": "bban",
  "name": "ABC bank account",
  "owner": {
    "name": "ABC Corporation",
    "organizationNumber": "123456789",
    "contact": {
      "name": "John Doe",
      "email": "doe@example.com"
    }
  }
}
Response examples (201)
[
  {
    "id": "123-456-789",
    "bic": "DNBANOKKXXX",
    "name": "ABC bank account",
    "type": "bban",
    "owner": {
      "name": "ABC Corporation",
      "contact": {
        "name": "John Doe",
        "email": "doe@example.com"
      },
      "organizationNumber": "123456789"
    },
    "number": "90000000001",
    "createdAt": "2022-01-01T18:00:00.000Z",
    "modifiedAt": "2022-01-01T18:00:00.000Z"
  }
]