---
title: "List account accruals v3"
method: GET
path: "/statements-v2/v3/accounts/{accountId}/interest-accruals"
tags: ["Accruals"]
---

# List account accruals v3

`GET /statements-v2/v3/accounts/{accountId}/interest-accruals`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/statements-v2/v3/accounts/{accountId}/interest-accruals`
- Auth: HTTP bearer

List account accruals with filtering options. You must specify the period using `beginDate` and `endDate`, and this period must be less than or equal to 30 days. If you specify a period greater than this, the endpoint returns an error.

The period is restricted to 30 days for performance reasons. A larger period could return a very large number of accruals.

**Note:** This endpoint requires an account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a **401 Unauthorized** message.

## Path parameters

- `accountId` integer, required

## Query parameters

- `beginDate` string, date, required
- `endDate` string, date, required
- `accrualType` 'OVERDUE' | 'REFINANCING' | 'IOF' | 'FINE'
- `status` 'PENDING' | 'PROCESSED' | 'STOP_ACCRUAL' | 'SETTLED'
- `interestAccrualId` integer
- `transactionId` integer
- `statementId` integer
- `page` integer
- `perPage` integer
- `includeNegative` boolean

## Response `200`

Ok

- InterestAccrualV3ListResponse
  - `current_page` integer: Current page
  - `per_page` integer: Items per page
  - `total_items` integer: Number of items found
  - `items_on_page` integer: Number of items on this page
  - `pages` integer: Number of pages
  - `is_last_page` boolean: Is this the last page?
  - `items` InterestAccrualV3Response[]
    - `interest_accrual_id` integer: Interest accrual ID
    - `created_at` string: Creation date/time. Format = yyyy-mm-ddThh:mm:ss.
    - `transaction_id` integer: Transaction ID
    - `statement_id` integer: Statement ID
    - `transaction_balance` number, float: Value of interest accrual transaction
    - `accrual_date` string, date: Accrual date. Format = yyyy-mm-dd.
    - `accrual_type` 'OVERDUE' | 'REFINANCING' | 'IOF' | 'FINE': Interest accrual type. Possible values: * `OVERDUE`: A daily charge applied to an unpaid balance if the minimum amount due (MAD) has not been paid. * `REFINANCING`: A daily charge applied to an unpaid balance if the MAD has been paid, but the total amount due has not. * `IOF`: A Brazilian tax * `FINE`: A one-time charge that's applied on the day an account becomes overdue.
    - `accrued_value` number, float: Accrued value
    - `status` 'PENDING' | 'PROCESSED' | 'STOP_ACCRUAL' | 'SETTLED': Interest accrual status. * `PENDING`: Accrual has been calculated but has not yet generated a transaction. * `PROCESSED`: Accrual has been processed and a transaction has been generated. * `STOP_ACCRUAL`: Due to a program parameter, the accrual has reached the maximum number of days to be posted as a transaction. For more information, refer to [Limiting the number of days accruals can be charged](doc:limiting-the-number-of-days-accruals-can-be-charged). * `SETTLED`: Accrual transaction has been settled.
    - `interest_rate` number, float: Transaction interest rate.
    - `additional_info` AdditionalInfo
      - `account_financial_classification` integer: Customer-defined number representing the financial classification of the account.

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/revolving-credit-statements.md) - [All operations](https://skmtc.dev/pismo/apis/revolving-credit-statements/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/revolving-credit-statements/revisions/09f552b0f850?raw)