---
title: "Get statement"
method: GET
path: "/statement/{account_name_with_address}"
tags: ["Balances and statements"]
---

# Get statement

`GET /statement/{account_name_with_address}`

Gets a statement for an account that lists payments and transfers that impacted the account's balance during a specified date-time range.

## Path parameters

- `account_name_with_address` string, required

## Query parameters

- `start-date` string, required
- `end-date` string, required
- `page` integer
- `size` integer

## Response `200`

Successfully returns an account statement.

- StatementResponse — Provides a statement for an account that lists payments and transfers that impacted the account's balance during a specified date-time range.
  - `account_name` string, required — Name of the account the statement covers.
  - `start_datetime` string, date-time, required — Lower bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.
  - `end_datetime` string, date-time, required — Upper bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.
  - `generated_at` string, date-time, required — Time at which the statement was generated, as an ISO-8601 timestamp in UTC.
  - `currency` string, required — Currency supported by the account.
  - `owner` string, required — Owner of the account
  - `opening_balance` number, required — Opening balance of the account for the given date range.
  - `closing_balance` number, required — Closing balance of the account for the given date range.
  - `transactions` Transactions, required — Provides a `content` array of statement record objects and a set of pagination information fields.
    - `content` StatementRecord[], required — Provides an array of statement record objects.
      - `transaction_id` string, uuid, required — ID of the payment or transfer that caused an account balance change.
      - `transaction_type` 'PAYMENT' | 'TRANSFER' | 'EXCHANGE_TRANSFER', required — Type of transaction that caused an account balance change.
      - `transaction_state` string, required — Current state of the payment or transfer.
      - `balance_change` number, required — Account balance change caused by the transaction.
      - `balance_result` number, required — Account balance after the transaction.
      - `created_at` string, date-time, required — Time at which the transaction was created, as an ISO-8601 timestamp in UTC.
      - `end_to_end_id` string, required — ID that the sender of a transaction can specify. Persisted on all xCurrent instances that participated in the transaction.
      - `internal_id` string, required — Internal identifier that the sender can optionally specify. Only visible to the sender. Only the sending xCurrent instance stores this ID.
      - `venue_id` string — The id from an exchange associated with a transaction involving an exchange account.
      - `transaction_hash` string — Hash representing the unique identifier for the transfer of funds in the XRP ledger.
      - `returns_payment_with_id` string, uuid, required — The `payment_id` of the original payment that this payment returns, if this is a returned payment. Always set to `null` if the `transaction_type` is set to `TRANSFER`.
      - `returned_by_payment_with_id` string, uuid, required — The `payment_id` of the return payment that returned this payment, if this is a returned payment. Always set to `null` if the `transaction_type` is set to `TRANSFER`.
      - `balance_change_created_at` string, date-time — Timestamp of when the balance change was created
      - `sender_address` string, required — RippleNet address of the sending account. Always set to `null` if the `transaction_type` is set to `TRANSFER`.
      - `receiver_address` string, required — RippleNet address of the recieving account. Always set to `null` if the `transaction_type` is set to `TRANSFER`.
    - `total_elements` integer, required — total elements in paginated response
    - `sort` string, required — retained for backward compatibility
    - `first` boolean, required — true if this is the first page.
    - `last` boolean, required — true if this is the last page.
    - `number` integer, required — page number
    - `numberOfElements` integer, required — Number Of elements in this request
    - `size` integer, required — page size
    - `totalPages` integer, required — Total number of pages for the given request

## Other responses

- `400` — Bad request.
- `404` — Peer or Account not found.

---

[API](https://skmtc.net/ripple/apis/ripplenet-server-api.md) · [All operations](https://skmtc.net/ripple/apis/ripplenet-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripplenet-server-api/versions/7843f07ca150/schema)