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

Authorization string Required

Authorization header

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.

Additional properties are allowed.
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.
  
  Additional properties are allowed.
  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
- Access-Control-Allow-Origin string
- Access-Control-Allow-Credentials string
- X-Trace-Id string
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.
  
  Additional properties are allowed.
  
  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.
  
  Additional properties are allowed.
  
  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.
  
  Additional properties are allowed.
  
  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.
  
  Additional properties are allowed.
  
  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"
  }
]