---
title: "Get Balance Statement"
method: GET
path: "/v1/profiles/{profileId}/balance-statements/{balanceId}/statement.json"
tags: ["balance-statement"]
---

# Get Balance Statement

`GET /v1/profiles/{profileId}/balance-statements/{balanceId}/statement.json`

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).

{% admonition type="warning" %}
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](/guides/developer/auth-and-security/sca-and-2fa)
{% /admonition %}

## Path parameters

- `profileId` integer, required
- `balanceId` integer, required

## Query parameters

- `currency` string, required
- `intervalStart` string, date-time, required
- `intervalEnd` string, date-time, required
- `type` 'COMPACT' | 'FLAT'
- `statementLocale` string

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

OK - Successfully retrieved balance statement.

- object — Balance statement containing transactional activities.
  - `accountHolder` object — Account holder information.
    - `type` 'PERSONAL' | 'BUSINESS' — Account holder type.
    - `address` object — Account holder address.
      - `addressFirstLine` string — Street address.
      - `city` string — City.
      - `postCode` string — Postal/ZIP code.
      - `stateCode` string — State code.
      - `countryName` string — Country name.
    - `firstName` string — Account holder first name.
    - `lastName` string — Account holder last name.
  - `issuer` object — Account issuer information.
    - `name` string — Issuer name.
    - `firstLine` string — Street address.
    - `city` string — City.
    - `postCode` string — Postal/ZIP code.
    - `stateCode` string — State code.
    - `country` string — Country.
  - `bankDetails` object, nullable — Local bank details for the account.
  - `transactions` object[] — List of transactions in the statement period.
    - `type` 'DEBIT' | 'CREDIT' — Transaction direction.
    - `date` string, date-time — Date when transaction was created.
    - `amount` object — Transaction amount.
      - `value` number — Amount value (negative for debits).
      - `currency` string — Currency code.
    - `totalFees` object — Transaction fees.
      - `value` number — Fee amount.
      - `currency` string — Currency code.
    - `details` object — Transaction details.
      - `type` 'CARD' | 'CONVERSION' | 'DEPOSIT' | 'TRANSFER' | 'MONEY_ADDED' | 'INCOMING_CROSS_BALANCE' | 'OUTGOING_CROSS_BALANCE' | 'DIRECT_DEBIT' | 'BALANCE_INTEREST' | 'BALANCE_ADJUSTMENT' | 'UNKNOWN' | 'ACCRUAL_CHARGE' | 'INVESTMENT_TRADE_ORDER' | 'ACQUIRING_PAYMENT' | 'CARD_CASHBACK' | 'CARD_ORDER_CHECKOUT' — Transaction type.
      - `description` string — Human readable explanation about the transaction.
      - `amount` object — Amount in original currency (for card transactions abroad).
        - `value` number
        - `currency` string
      - `senderName` string — Deposit sender name.
      - `senderAccount` string — Deposit sender bank account details.
      - `paymentReference` string — Deposit payment reference text.
      - `category` string — Card transaction category.
      - `merchant` object — Card transaction merchant details.
        - `name` string — Merchant name.
        - `firstLine` string, nullable — Merchant address street.
        - `postCode` string — Merchant address postal code.
        - `city` string — Merchant address city.
        - `state` string — Merchant address state.
        - `country` string — Merchant address country.
        - `category` string — Merchant category.
      - `sourceAmount` object — Source amount for conversions.
        - `value` number
        - `currency` string
      - `targetAmount` object — Target amount for conversions.
        - `value` number
        - `currency` string
      - `fee` object — Conversion fee.
        - `value` number
        - `currency` string
      - `rate` number — Conversion exchange rate.
    - `exchangeDetails` object, nullable — Exchange details for card transactions abroad.
      - `forAmount` object
        - `value` number
        - `currency` string
      - `rate` number, nullable — Exchange rate applied.
    - `runningBalance` object — Running balance after the transaction.
      - `value` number
      - `currency` string
    - `referenceNumber` string — Wise assigned unique transaction reference number. Can be used to map refunds to the original transfer.
  - `endOfStatementBalance` object — Closing balance for the specified time period.
    - `value` number — Balance value.
    - `currency` string — Currency code.
  - `query` object — Query parameters used for the request.
    - `intervalStart` string, date-time — Statement start time.
    - `intervalEnd` string, date-time — Statement end time.
    - `currency` string — Currency code.
    - `accountId` integer — Balance account ID.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)