BizKitHub
DocsAPI ReferenceBank Statement/bff/bank-statement/
getBank StatementAdmin BFF

/bff/bank-statement/

Returns every stored monthly statement PDF for the caller organisation, newest period first. Each row carries the download URL of the PDF blob plus enough bank-account metadata to render a grid without an extra lookup. Filter server-side by bank account (external id) and/or by year/month.

Bank statementgetBffBank-statement

Parameters

3 query

Query parameters

· 3
bankAccountExternalIdstringOptional

Restrict to statements of one bank account.

Exampleexample_bankAccountExternalId
yearnumberOptional

Filter by calendar year of the period (e.g. 2026).

Example0
monthnumberOptional

Filter by calendar month (1-12) of the period.

Range: 1–12
Example0

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
externalIdstringRequired

Blob token (immutable). Use as row key and download identifier.

bankAccountExternalIdstring | nullRequired

16-char external id of the source bank account.

One of 2:
Variant 1
string
Variant 2
null
bankAccountDisplayNamestring | nullRequired

Human-readable label of the source account.

One of 2:
Variant 1
string
Variant 2
null
ibanstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
accountNumberstring | nullRequired

Domestic account number without slash.

One of 2:
Variant 1
string
Variant 2
null
bankCodestring | nullRequired

4-digit Czech bank code.

One of 2:
Variant 1
string
Variant 2
null
yearnumberRequired

Calendar year of the statement period.

monthnumberRequired

Calendar month (1-12) of the statement period.

periodStartstringRequired

ISO date of the first day covered by the statement.

periodEndstringRequired

ISO date of the last day covered by the statement.

byteSizenumberRequired

PDF size in bytes.

sourcestringRequired

Origin of the PDF (e.g. "fio_api").

Examplefio_api
downloadedDatestringRequired

ISO timestamp when the PDF was pulled from the bank.

filenamestringRequired

Human-facing filename for downloads.

contentTypestringRequired

Blob content type, always application/pdf for statements.

downloadUrlstringRequired

Signed public download URL for the private PDF blob.

Response example

application/json
{
  "items": [
    {
      "externalId": "example_externalId",
      "year": 0,
      "month": 0,
      "periodStart": "example_periodStart",
      "periodEnd": "example_periodEnd",
      "byteSize": 0,
      "source": "fio_api",
      "downloadedDate": "example_downloadedDate",
      "filename": "example_filename",
      "contentType": "example_contentType",
      "downloadUrl": "example_downloadUrl"
    }
  ]
}

Request example

GET /bff/bank-statement/

get
curl -X GET "https://api.bizkithub.com/bff/bank-statement/?bankAccountExternalId=example_bankAccountExternalId&year=0&month=0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key