Account Statements

An Account Statement is a monthly PDF document that summarizes all movements for a given account during a specific period. Statements are generated automatically for every active account and comply with local regulatory requirements.

You can list and download statements through the API or from the Dashboard.

The Account Statement object

Field	Type	Description
`id`	string	Unique identifier for the statement (e.g., `stmt_8kR2vP4xNbQm1A`)
`object`	string	Always `"account_statement"`
`account_id`	string	The account this statement belongs to (`acc_xxx`)
`period`	string	The month covered by this statement (e.g., `"2026-03"`)
`download_url`	string	URL to download the PDF. Expires after a short time window.
`created_at`	string	ISO 8601 timestamp of when the statement was generated

List statements

GET /v2/accounts/{account_id}/statements

Returns a list of statements for the given account. Use since and until to filter by period.

Parameter	Type	Required	Description
`account_id`	string	Yes	The `acc_` ID of the account
`since`	string	No	ISO 8601 date. Only return statements with period on or after this date
`until`	string	No	ISO 8601 date. Only return statements with period on or before this date

Request:

curl https://api.fintoc.com/v2/accounts/acc_Lq7dP901xZgA2B/statements?since=2026-01-01 \
  -H "Authorization: sk_live_xxxxx"

Response:

[
  {
    "id": "stmt_8kR2vP4xNbQm1A",
    "object": "account_statement",
    "account_id": "acc_Lq7dP901xZgA2B",
    "period": "2026-03",
    "download_url": "https://storage.fintoc.com/statements/stmt_8kR2vP4xNbQm1A.pdf?signature=xxx&expires=1712000000",
    "created_at": "2026-04-01T06:00:00Z"
  },
  {
    "id": "stmt_3mT7wK9yFcLp5B",
    "object": "account_statement",
    "account_id": "acc_Lq7dP901xZgA2B",
    "period": "2026-02",
    "download_url": "https://storage.fintoc.com/statements/stmt_3mT7wK9yFcLp5B.pdf?signature=xxx&expires=1712000000",
    "created_at": "2026-03-01T06:00:00Z"
  }
]

Downloading the PDF

The download_url field contains a signed URL. Make a GET request to that URL to download the PDF file directly. The URL expires after a short time — if it has expired, list the statements again to get a fresh URL.

SDKs

client = Fintoc("sk_live_xxxxx")
statements = client.accounts.retrieve("acc_Lq7dP901xZgA2B").statements.list(
    since="2026-01-01",
    until="2026-03-31"
)
for stmt in statements:
    print(stmt.period, stmt.download_url)

const client = new Fintoc("sk_live_xxxxx");
const statements = await client.accounts
  .retrieve("acc_Lq7dP901xZgA2B")
  .statements.list({ since: "2026-01-01", until: "2026-03-31" });

client = Fintoc::Client.new("sk_live_xxxxx")
statements = client.accounts
  .retrieve("acc_Lq7dP901xZgA2B")
  .statements.list(since: "2026-01-01", until: "2026-03-31")

Statements are generated automatically at the beginning of each month for the previous period. No action is required on your end.