v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Bank statements

Create account balance history config v1

Create an account balance history configuration by division code.

The configuration becomes effective on the day after the cycle closing time plus the cycle event delay. Example:

Division timezone: UTC
Create account balance history configuration is called at: 2023-05-01T18:00:00Z
Account balance history configuration cycle_closing_time is: 22:00:00
Account balance history configuration cycle_event_delay is: 10
Account balance history configuration starts at 2023-05-01T22:10:00Z

This endpoint generates an Account balance history configuration created event.

post/bank-statements/v1/account-balances/history/config

Request body

division_codestring required

Division code registered in the Create division endpoint.

cycle_closing_timestring time required

Time of day the cycle closes for a division. This time follows the timezone configured in division. You can find the division timezone using the Get division by code endpoint.

cycle_event_delayinteger required

The cycle event delay specifies how many minutes after cycle_closing_time the account balance history event is issued for each account in the division.

Example request

{
  "division_code": "US",
  "cycle_closing_time": "22:00:00",
  "cycle_event_delay": 15
}

Response

Created

cycle_closing_timestring time

Time of day the cycle closes for a division. This time follows the timezone configured in division. You can find the division timezone using the Get division by code endpoint.

cycle_event_delayinteger

The cycle event delay specifies how many minutes after cycle_closing_time the account balance history event is issued for each account in the division.

Example response

{
  "cycle_closing_time": "22:00:00",
  "cycle_event_delay": 15,
  "cycle_config_validity": {
    "start": "2023-04-01T22:10:00Z",
    "end": "2023-05-01T22:10:00Z"
  }
}