Read a bank account by ID

GET /bankaccounts/{id}

Read details for a specific bank account identified by its unique identifier. The response includes information such as account number, BIC, type, name, owner details, creation timestamp, modification timestamp, and the latest balance information, should there be one available.

Headers

Authorization string Required

Authorization header

Path parameters

id string Required

Query parameters

before string(date)

The date to get the balance from. The balance returned will be the last balance before this date. If omitted, the current date is used. The date format here is YYYY-MM-DD.

Responses

200 application/json

Successful operation
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
  
  The account number of the bank account.
- bic string
  
  The Business Identifier Codes (BIC) for the bank that manages the bank account.
- type string
  
  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
  
  A user-defined name of the bank account, as it is shown in 24SevenOffice.
- owner object
  
  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.
- transactionType object
  
  The transaction type within the 24SevenOffice accounting module, used when posting bank transactions in the 24SevenOffice bank module. Transaction types can be retrieved from the separate /transactiontypes endpoint.
  
  Hide transactionType attribute Show transactionType attribute object
  
  number number Required
  
  A unique number representing the transaction type.
- ledgerAccount object
  
  The ledger account within the 24SevenOffice accounting module that corresponds to this bank account. Accounts can be retrieved from the separate /accounts endpoint.
  
  Hide ledgerAccount attribute Show ledgerAccount attribute object
  
  number number Required
  
  The unique number that indicates which type of account it belongs to.
- 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.

GET /bankaccounts/{id}

curl \
 --request GET 'https://rest.api.24sevenoffice.com/v1/bankaccounts/{id}' \
 --header "Authorization: string"

Response examples (200)

[
  {
    "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",
    "balance": {
      "amount": 1100,
      "currency": {
        "code": "NOK"
      },
      "timestamp": "2024-06-02T12:00:00.000Z"
    },
    "createdAt": "2022-01-01T18:00:00.000Z",
    "modifiedAt": "2023-12-31T18:00:00.000Z",
    "ledgerAccount": {
      "number": 1920
    },
    "transactionType": {
      "number": 5
    }
  }
]

[
  {
    "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",
    "ledgerAccount": {
      "number": 1920
    },
    "transactionType": {
      "number": 5
    }
  }
]