---
title: "Get Statements"
method: GET
path: "/statements"
tags: ["Statements"]
---

# Get Statements

`GET /statements`

Enables an AISP to retrieve statement information for account(s) that the PSU has consented to.

## Query parameters

- `fromStatementDateTime` string, date-time
- `toStatementDateTime` string, date-time

## Headers

- `x-fapi-auth-date` string
- `x-fapi-customer-ip-address` string
- `x-fapi-interaction-id` string
- `Authorization` string, required
- `x-customer-user-agent` string
- `x-client-id` string

## Response `200`

Statements Read

- OBReadStatement2
  - `Data` OBReadDataStatement2, required
    - `Statement` OBStatement2[]
      - `AccountId` string, required — A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
      - `StatementId` string — Unique identifier for the statement resource within a servicing institution. This identifier is both unique and immutable.
      - `StatementReference` string — Unique reference for the statement. This reference may be optionally populated if available.
      - `Type` 'AccountClosure' | 'AccountOpening' | 'Annual' | 'Interim' | 'RegularPeriodic', required — Statement type, in a coded form. For a full list of values see `OBInternalStatementType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
      - `StartDateTime` string, date-time, required — Date and time at which the statement period starts. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
      - `EndDateTime` string, date-time, required — Date and time at which the statement period ends. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
      - `CreationDateTime` string, date-time, required — Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
      - `StatementDescription` string[]
      - `StatementBenefit` object[]
        - `Type` string, required — Benefit type, in a coded form. For a full list of values see `OBInternalStatementBenefitType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
        - `Amount` OBActiveOrHistoricCurrencyAndAmount5, required — Amount of money associated with the statement benefit type.
          - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
          - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
      - `StatementFee` object[]
        - `Description` string — Description that may be available for the statement fee.
        - `CreditDebitIndicator` 'Credit' | 'Debit', required — Indicates whether the amount is a credit or a debit. For a full list of values see `OBInternalCreditDebitCode` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)<br /> Usage: A zero amount is considered to be a credit amount.
        - `Type` string, required — Fee type, in a coded form. For a full list of values see `OBInternalStatementFeeType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
        - `Rate` number — Rate charged for Statement Fee (where it is charged in terms of a rate rather than an amount)
        - `RateType` string — This code indicates the specific type of fee rate (e.g., AER, EAR). For a full list of values see `OBInternalStatementFeeRateType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
        - `Frequency` string — How frequently the fee is applied to the Account. For a full list of values see `OBInternalStatementFeeFrequency1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
        - `Amount` OBActiveOrHistoricCurrencyAndAmount6, required — Amount of money associated with the statement fee type.
          - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
          - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
      - `StatementInterest` object[]
        - `Description` string — Description that may be available for the statement interest.
        - `CreditDebitIndicator` 'Credit' | 'Debit', required — Indicates whether the amount is a credit or a debit. For a full list of values see `OBInternalCreditDebitCode` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)<br /> Usage: A zero amount is considered to be a credit amount.
        - `Type` string, required — Interest amount type, in a coded form. For a full list of values see `OBInternalStatementInterestType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
        - `Rate` number — Rate for Statement Interest (where it is applicable in terms of a rate rather than an amount)
        - `RateType` string — This code specifies the type of interest (e.g., BOE Base Rate, Fixed Rate, Gross).
        - `Frequency` string — Specifies the statement fee type requested. For a full list of values see `OBInternalStatementInterestFrequency1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
        - `Amount` OBActiveOrHistoricCurrencyAndAmount7, required — Amount of money associated with the statement interest amount type.
          - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
          - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
      - `StatementAmount` object[]
        - `CreditDebitIndicator` 'Credit' | 'Debit', required — Indicates whether the amount is a credit or a debit. For a full list of values see `OBInternalCreditDebitCode` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)<br /> Usage: A zero amount is considered to be a credit amount.
        - `Type` string, required — Amount type, in a coded form.
        - `Amount` object, required — Amount of money of the cash balance.
          - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
          - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
          - `SubType` 'BCUR' | 'LCUR' — The amount in the domestic or base accounting currency. Default is Base Currency (BCUR) if not specified
        - `LocalAmount` object — Optional component providing the equivalent of Amount in local currency.
          - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
          - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
          - `SubType` 'BCUR' | 'LCUR' — The amount in the local market currency for which the asset is held. Default is Local Currency (LCUR) if not specified
      - `StatementDateTime` object[]
        - `DateTime` string, date-time, required — Date and time associated with the date time type. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
        - `Type` string, required — Date time type, in a coded form. For a full list of values see `OBInternalStatementDateTimeType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
      - `StatementRate` object[]
        - `Rate` string, required — Rate associated with the statement rate type.
        - `Type` string, required — Statement rate type, in a coded form. For a full list of values see `OBInternalStatementRateType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
      - `StatementValue` object[]
        - `Value` string, required — Value associated with the statement value type.
        - `Type` string, required — Statement value type, in a coded form. For a full list of values see `OBInternalStatementValueType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
      - `TotalValue` object — Combined sum of all Amounts in the accounts base currency
        - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
        - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
  - `Links` Links — Links relevant to the payload
    - `Self` string, uri, required
    - `First` string, uri
    - `Prev` string, uri
    - `Next` string, uri
    - `Last` string, uri
  - `Meta` Meta — Meta Data relevant to the payload
    - `TotalPages` integer
    - `FirstAvailableDateTime` string, date-time — All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
    - `LastAvailableDateTime` string, date-time — All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `405` — Method Not Allowed
- `406` — Not Acceptable
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/openbankinguk/apis/account-and-transaction-api-specification.md) · [All operations](https://skmtc.net/openbankinguk/apis/account-and-transaction-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openbankinguk/account-and-transaction-api-specification/revisions/b1c449c8ecb0/schema)