v1

latestOpenAPI 3.1.02026-07-228956435.8 KB

Account statements

List account statements

Lists the account statements of one of your accounts for the live or test mode of the API key you use. Filter by date range with the since and until query parameters. The response is paginated. Use starting_after, ending_before, and limit to page through the results. When more results are available, the Link response header carries the URL of the next page.

get/accounts/{account_id}/account_statements

Path parameters

account_idstring required

Unique identifier of the account whose statements you want to list.

Query parameters

sincestring

Example:2026-01-01

Lower bound for the statement period. Returns statements whose end_date is on or after this ISO 8601 date.

untilstring

Example:2026-03-31

Upper bound for the statement period. Returns statements whose start_date is on or before this ISO 8601 date.

starting_afterstring

Example:acst_2rNxBkOrlHoOYsZTyQYhA0o8Ek0

Cursor that fetches the next page of account statements. Use the ID of the last account statement from the current page.

ending_beforestring

Example:acst_2rNxBkOrlHoOYsZTyQYhA0o8Ek0

Cursor that fetches the previous page of account statements. Use the ID of the first account statement from the current page.

limitinteger

Example:50

Maximum number of account statements to return per page. Ranges from 1 to 300. Defaults to 30.

Response

List of account statements for the account.

idstring required

Unique identifier of the account statement.

object'account_statement' required

Type of the object. Always account_statement.

created_atstring date-time required

Point in time when Fintoc generated the statement, as an ISO 8601 datetime in UTC.

download_urlstring nullable required

URL to download the statement PDF. null when the file is not yet available.

end_datestring date required

Last day covered by the statement, as an ISO 8601 date.

final_balance_centsinteger required

Account balance at the end of the period, in the smallest currency unit.

initial_balance_centsinteger required

Account balance at the start of the period, in the smallest currency unit.

start_datestring date required

First day covered by the statement, as an ISO 8601 date.

total_credited_centsinteger required

Total credited during the period, in the smallest currency unit.

total_debited_centsinteger required

Total debited during the period, in the smallest currency unit.

Example response

[
  {
    "id": "acst_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
    "created_at": "2026-03-01T12:00:00.000Z",
    "download_url": "https://fintoc.com/account_statements/astmt.pdf",
    "end_date": "2026-02-28",
    "final_balance_cents": 1500000,
    "initial_balance_cents": 1000000,
    "start_date": "2026-02-01",
    "total_credited_cents": 1000000,
    "total_debited_cents": 500000
  }
]