Balance Statements

Balance statements contain transactional activities on a Wise Multi-Currency Account, including deposits, withdrawals, conversions, card transactions, and fees.

Statements can be retrieved in multiple formats: JSON, CSV, PDF, XLSX, CAMT.053, MT940, or QIF.

Operations

Get Balance Statement

Request

Retrieve a statement for the specified balance account.

The response format depends on the URL path:

statement.json - JSON format
statement.csv - CSV format
statement.pdf - PDF format (includes Wise branding)
statement.xlsx - Excel format
statement.xml - CAMT.053 XML format
statement.mt940 - MT940 format
statement.qif - QIF format

The period between intervalStart and intervalEnd cannot exceed 469 days (around 1 year 3 months).

This endpoint is SCA protected when it applies. If your profile is registered within the UK and/or EEA, SCA most likely applies to you. The additional authentication is only required once every 90 days, viewing the statement on the website or in the mobile app counts towards that as well.

Learn more

Security

UserToken or PersonalToken

Path

profileIdinteger, (int64)required

The profile ID.

Example:12345

balanceIdinteger, (int64)required

The balance ID to get the statement for.

Example:64

Query

currencystringrequired

Currency of the balance statement requested (ISO 4217 Alphabetic Code).

Example:currency=EUR

intervalStartstring, (date-time)required

Statement start time in UTC.

Example:intervalStart=2025-03-01T00:00:00.000Z

intervalEndstring, (date-time)required

Statement end time in UTC.

Example:intervalEnd=2025-04-30T23:59:59.999Z

typestring

Statement type:

COMPACT - Single statement line per transaction
FLAT - Accounting statements where transaction fees are on a separate line

Enum:"COMPACT""FLAT"

Example:type=COMPACT

statementLocalestring

Language for the statement. Supports 2 character language codes.

Example:statementLocale=en

X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479

curl -i -X GET \
  'https://api.wise.com/v1/profiles/12345/balance-statements/64/statement.json?currency=EUR&intervalStart=2025-03-01T00%3A00%3A00.000Z&intervalEnd=2025-04-30T23%3A59%3A59.999Z&type=COMPACT&statementLocale=en' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

Responses

OK - Successfully retrieved balance statement.

Headers

X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"

x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"

Bodyapplication/json

accountHolderobject

Account holder information.

issuerobject

Account issuer information.

bankDetailsobject or null

Local bank details for the account.

transactionsArray of objects

List of transactions in the statement period.

endOfStatementBalanceobject

Closing balance for the specified time period.

queryobject

Query parameters used for the request.

Response

{
  "accountHolder": {
    "type": "PERSONAL",
    "address": {
      "addressFirstLine": "Veerenni 24",
      "city": "Tallinn",
      "postCode": "12112",
      "stateCode": "",
      "countryName": "Estonia"
    },
    "firstName": "Oliver",
    "lastName": "Wilson"
  },
  "issuer": {
    "name": "TransferWise Ltd.",
    "firstLine": "56 Shoreditch High Street",
    "city": "London",
    "postCode": "E1 6JJ",
    "stateCode": "",
    "country": "United Kingdom"
  },
  "bankDetails": {},
  "transactions": [
    {
      "type": "DEBIT",
      "date": "2018-04-30T08:47:05.832Z",
      "amount": { … },
      "totalFees": { … },
      "details": { … },
      "exchangeDetails": { … },
      "runningBalance": { … },
      "referenceNumber": "CARD-249281"
    }
  ],
  "endOfStatementBalance": {
    "value": 9.94,
    "currency": "EUR"
  },
  "query": {
    "intervalStart": "2018-03-01T00:00:00Z",
    "intervalEnd": "2018-04-30T23:59:59.999Z",
    "currency": "EUR",
    "accountId": 64
  }
}