Skip to main content
Flinks can retrieve original bank-issued PDF statements directly from supported Canadian financial institutions.
This feature is only available for clients based in Canada. Contact your Flinks Representative to enable it for your instance.

Enabling statement retrieval

To enable statement retrieval, add the following parameters to your Flinks Connect iframe URL:
ParameterTypeDefaultDescription
detailsAndStatementEnablebooleanfalseEnables PDF statement extraction alongside account data
monthsOfStatementsstringMonths3Number of months to retrieve: MostRecent, Months3, or Months12
Example iframe URL with statements enabled:
https://{instance}-iframe.private.fin.ag/?detailsAndStatementEnable=true&monthsOfStatements=Months12&...

Retrieving statements via API

After enabling statements in the iframe, retrieve them using the /GetStatements endpoint.

Step 1: Authorize

Call /Authorize with the customer’s loginId to get a requestId:
curl -X POST \
  https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/Authorize \
  -H 'Content-Type: application/json' \
  -d '{
    "LoginId": "{loginId}",
    "MostRecentCached": true
  }'

Step 2: Request statements

Call /GetStatements with the requestId:
curl -X POST \
  https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/GetStatements \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestId": "{requestId}"
  }'

Step 3: Decode the response

The API returns statements as Base64-encoded strings. Decode each string to produce the original PDF file:
import base64

# statement_base64 is the Base64 string from the API response
pdf_bytes = base64.b64decode(statement_base64)

with open("statement.pdf", "wb") as f:
    f.write(pdf_bytes)

Retrieving statements via Dashboard

If you have Dashboard access, you can download statements directly:
  1. Open a request from the Request Feed.
  2. Navigate to the account details.
  3. Click Download Statement to save the PDF.
For BMO accounts, statements are provided in CSV format rather than PDF.