---
title: "Configure timing for accrual calculation"
method: POST
path: "/v1/interest/accrual/setup"
tags: ["Interest accrual"]
---

# Configure timing for accrual calculation

`POST /v1/interest/accrual/setup`

## Request

- Base URL: `https://sandbox.pismolabs.io/interest-engine`
- URL: `https://sandbox.pismolabs.io/interest-engine/v1/interest/accrual/setup`
- Auth: HTTP bearer

Set up the time when the daily accrual calculations should occur.

If you pass a value for `division_id`, then the value passed in `time_utc` is only used for the corresponding division. That is, it's only used for the accruals of installment plans associated with that division.

If you don't pass a value for `division_id`, then the value passed in `time_utc` is used for all installment plans in the program's org, unless they are associated with a division that already has a time assigned to it. (That is, unless you already ran the endpoint with `division_id` set to the ID for that division.)

<b>Note:</b> If you run the endpoint a second time using the same value `division_id`, it generates an error. This also happens if you run the endpoint twice without passing a value for `division_id`.

## Request body

- InterestAccrualSetupRequest
  - `time_utc` '04:05' | '05:05' | '06:05' | '07:05' | '08:05' | '09:05' | '10:05' | '19:15', required: Time when accrual calculation is performed, specified in hours and minutes. `04:05`, `05:05`, `06:05`, `07:05`, `08:05`, `09:05`, `10:05` and `19:15` are the only values accepted.
  - `division_id` string: Division ID attached to the interest plan for accrual by division

## Response `200`

OK

- InterestAccrualSetupResponse
  - `time_utc` '04:05' | '05:05' | '06:05' | '07:05' | '08:05' | '09:05' | '10:05' | '19:15', required: Time when accrual calculation is performed, specified in hours and minutes. `04:05`, `05:05`, `06:05`, `07:05`, `08:05`, `09:05`, `10:05` and `19:15` are the only values accepted.
  - `division_id` string: Division ID attached to the interest plan for accrual by division

## Other responses

- `400`: Bad request
- `401`: Unauthorized. The response body is produced by the upstream authentication gateway and is not defined by this service.
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/banking-interest-engine.md) - [All operations](https://skmtc.dev/pismo/apis/banking-interest-engine/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-interest-engine/revisions/50c20b2cac0c?raw)