Read account balances

GET /accountbalances

Read a list of account balances with monthly changes for a defined period.

Headers

Query parameters

  • dateFrom string(date) Required

    The starting date from which balances will be retrieved.

  • dateTo string(date) Required

    The ending date until which balances will be retrieved.

  • periods string

    Specifies the periods for which the balances will be retrieved.

    Format should match the following pattern: ^\d{4}-\d{2}-\d{2}Z?(,\d{4}-\d{2}-\d{2}Z?)*$.

  • type string

    Specifies the type of data to be retrieved.

    Values are Date or Period. Default value is Date.

  • Indicates whether to include incoming amounts in the response. Default is false.

    Default value is false.

Responses

  • OK

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • account object

      Information about the account for which the balances belong to.

      Hide account attributes Show account attributes
      • id number

        A unique identifier for the account within 24SevenOffice accounting module.

      • number number

        The unique number that indicates which type of account it belongs to.

      • name string

        The human-readable name that describes the purpose or nature of the account.

    • balances array[object]

      The monthly change in balance for an account during a specific period.

      Hide balances attributes Show balances attributes object
      • date string(date)

        The date corresponding to the balance change.

      • opening number

        The opening balance of the account for the specified period.

      • closing number

        The closing balance of the account for the specified period.

      • change number

        The change in balance for the account during the specified period.

    Hide response attributes Show response attributes object
    • Hide _embedded attribute Show _embedded attribute
      • records array[object]
        Hide records attributes Show records attributes object
        • account object

          Information about the account for which the balances belong to.

          Hide account attributes Show account attributes
          • id number

            A unique identifier for the account within 24SevenOffice accounting module.

          • number number

            The unique number that indicates which type of account it belongs to.

          • name string

            The human-readable name that describes the purpose or nature of the account.

        • balances array[object]

          The monthly change in balance for an account during a specific period.

          Hide balances attributes Show balances attributes object
          • date string(date)

            The date corresponding to the balance change.

          • opening number

            The opening balance of the account for the specified period.

          • closing number

            The closing balance of the account for the specified period.

          • change number

            The change in balance for the account during the specified period.

    • beginningAt string(date)
    • endingAt string(date)
    • fiscals array[object]
      Hide fiscals attributes Show fiscals attributes object
GET /accountbalances
curl \
 -X GET https://rest.api.24sevenoffice.com/v1/accountbalances?dateFrom=2024-05-04&dateTo=2024-05-04 \
 -H "Authorization: string"
Response examples (200)
[
  {
    "account": {
      "id": 1000001,
      "name": "Cash, NOK",
      "number": 1900
    },
    "balances": [
      {
        "date": "2024-01-01",
        "change": 5000,
        "closing": 55000,
        "opening": 50000
      },
      {
        "date": "2024-02-01",
        "change": 5000,
        "closing": 60000,
        "opening": 55000
      }
    ]
  },
  {
    "account": {
      "id": 1000002,
      "name": "Bank Account",
      "number": 1920
    },
    "balances": [
      {
        "date": "2024-01-01",
        "change": 5000,
        "closing": 85000,
        "opening": 80000
      },
      {
        "date": "2024-02-01",
        "change": 5000,
        "closing": 90000,
        "opening": 85000
      }
    ]
  },
  {
    "account": {
      "id": 2000001,
      "name": "Accounts Receivable",
      "number": 1500
    },
    "balances": [
      {
        "date": "2024-01-01",
        "change": 10000,
        "closing": 110000,
        "opening": 100000
      },
      {
        "date": "2024-02-01",
        "change": 10000,
        "closing": 120000,
        "opening": 110000
      }
    ]
  }
]