Skip to content

Bank statements

Bank statements are uploaded through the documents endpoint which details file types and size limitations.

IMPORTANT

While the documents endpoint lists image formats as accepted types, only PDFs are accepted for Bank Statements. We are working on accepting image bank statements, please bare with us!

Extracted data

These are the extracted fields of a bank statement

Personal data

The header section of a bank statement includes information on the individual. This is extracted into the following fields:

  • Full name
  • Address1
  • Address2
  • Address3
  • Address4
  • Address5
  • Address6
  • Address7
  • Address8

General account and statement information

We extract the following bank and account information:

  • Bank name
  • Sort code
  • Account number
  • Currency
  • Has overdraft

Statement summary extracted fields:

  • Period start date - The start date of the time period covered by the statement.
  • Period end date - The end date of the time period covered by the statement.
  • Opening balance
  • Closing balance

Daily balances

Daily balances are the balances of the account on any individual day. They are calculated from the transactions.

Each daily balance includes

  • Date
  • Balance - The final balance of that day.

Transactions (BETA)

IMPORTANT

Transaction extraction is currently in beta and shouldn't be considered 100% reliable.

Each transaction contains the following fields:

  • Date
  • Amount - Positive numbers for deposits and negative numbers for withdrawals.
  • Description - Description of the transaction found on the statement.
  • Category - How we have categorized the transaction. Full list of categories below.
  • Balance - Account balance after the transaction.

Transaction categories

CategoryHigh risk
IncomeFalse
SavingsFalse
HousingFalse
Taxes / InsuranceFalse
LivingFalse
UtilitiesFalse
Gambling⚠️ True
EntertainmentFalse
Entertainment (Adult)⚠️ True
Benefit income⚠️ True
HIST⚠️ True
TransferFalse
Cash deposit⚠️ True
Cash withdrawalFalse
CreditFalse
DeclinedFalse
MiscellaneousFalse

Example extraction

json
{
    "fullName": "James Smith",
    "address1": "12 Golf Road",
    "address2": "",
    "address6": "Cardiff",
    "address7": "123 123",
    "address8": "GB",
    "periodStartDate": "2025-02-01T00:00:00",
    "periodEndDate": "2025-02-28T00:00:00",
    "openingBalance": 731.62,
    "closingBalance": 1392.29,
    "hasOverdraft": false,
    "bankName": "Monzo",
    "accountNumber": "99999999",
    "sortCode": "00-00-00",
    "currency": "GBP",
    "dailyBalances": [
        {
            "date": "2025-02-01T00:00:00",
            "balance": 853.50
        }
    ],
    "transactions": [
        {
            "date": "2025-02-21T00:00:00",
            "amount": -19.00,
            "description": "Netflix subscription",
            "category": "Entertainment",
            "balance": 1313.72
        }}
    ]
}