---
title: "Get account bookings"
method: GET
path: "/v1/accounts/{account_id}/bookings"
tags: ["Accounts"]
---

# Get account bookings

`GET /v1/accounts/{account_id}/bookings`

Returns an array containing all bookings for an account.

## Path parameters

- `account_id` string, required

## Query parameters

- `page[number]` string
- `page[size]` string
- `sort` 'booking_date' | 'valuta_date' | 'recorded_at' | 'id'
- `filter[id]` string
- `filter[recorded_at][min]` string
- `filter[recorded_at][max]` string
- `filter[valuta_date]` string
- `filter[booking_type]` string
- `filter[description]` string
- `filter[receiver_iban_virtual]` string
- `filter[transaction_id]` string

## Response `200`

The operation was successful.

- SolarisResourcesBooking[]
  - `id` string — ID of the booking.
  - `creation_date` string — The date when the booking was created. Do not expose this to the account holder(s).
  - `valuta_date` string — The valuta date of the booking (i.e., the date when the booking becomes effective).
  - `booking_date` string — The date when the booking was posted.
  - `booking_type` 'CANCELLATION_BOOKING' | 'CancellationCardTransaction' | 'CANCELLATION_CARD_TRANSACTION_DIRECT' | 'CANCELLATION_CHARGE_CARD' | 'CANCELLATION_CHARGE_DUNNING' | 'CANCELLATION_CHARGE_SEPA_DIRECT_DEBIT_RETURN' | 'CANCELLATION_CRYPTO_EXCHANGE' | 'CANCELLATION_CURRENCY_EXCHANGE_PARTNER' | 'CANCELLATION_DIRECT_DEBIT' | 'CANCELLATION_DOUBLE_BOOKING' | 'CANCELLATION_INTERNAL_TRANSFER' | 'CANCELLATION_INTERNATIONAL_CREDIT_TRANSFER' | 'CANCELLATION_INTEREST_ACCRUED' | 'CANCELLATION_INTEREST_ANNUITY' | 'CANCELLATION_INTEREST_LOAN' | 'CANCELLATION_LOAN_PAYOUT' | 'CANCELLATION_REBOOKING' | 'CANCELLATION_REBOOKING_INTEREST' | 'CANCELLATION_SEPA_CREDIT_TRANSFER_RETURN' | 'CANCELLATION_SEPA_DIRECT_DEBIT' | 'CANCELLATION_SEPA_DIRECT_DEBIT_RETURN' | 'CANCELLATION_TRANSFER_ANNUITY' | 'CARD_DIRECT_DEBIT' | 'CARD_TRANSACTION' | 'CARD_TRANSACTION_DIRECT' | 'CASH_DEPOSIT_RETAIL' | 'CASH_WITHDRAWAL_RETAIL' | 'CHARGE_ACCOUNT_MAINTENANCE' | 'CHARGE_CARD' | 'CHARGE_DUNNING' | 'ChargeRecallRequest' | 'CHARGE_SEPA_DIRECT_DEBIT_RETURN' | 'ClosureBalanceTransfer' | 'COMMISSION_OVERDRAFT' | 'CREDIT_TRANSFER_CANCELLATION' | 'CRYPTO_EXCHANGE' | 'CURRENCY_EXCHANGE_PARTNER' | 'DIRECT_DEBIT' | 'FOREIGN_PAYMENT' | 'INTEREST_ACCRUED' | 'INTEREST_ANNUITY' | 'INTEREST_LOAN' | 'INTERNAL_TRANSFER' | 'INTERNATIONAL_CREDIT_TRANSFER' | 'LOAN_PAYOUT' | 'REBOOKING' | 'REBOOKING_INTEREST' | 'SEPA_CREDIT_TRANSFER' | 'SEPA_CREDIT_TRANSFER_RETURN' | 'SEPA_DIRECT_DEBIT' | 'SEPA_DIRECT_DEBIT_RETURN' | 'SEPAInstantCreditTransfer' | 'SepaInstantCreditTransferReturn' | 'TARGET2_CREDIT_TRANSFER' | 'TRANSFER_ANNUITY' | 'OTHER' — The type of the booking. See the [booking documentation](https://docs.solarisgroup.com/guides/digital-banking/account-management/#appendix-i-booking-types) for a list of explanations for each booking type.
  - `amount` SolarisResourcesMoneyWithUnit
    - `value` integer — The amount.
    - `unit` string — Money unit used to represent the amount.
    - `currency` string — The currency in which the amount is represented.
  - `description` string — A description of the booking.
  - `purpose_code` string — The purpose code of the booking.
  - `recipient_bic` string — The recipient's BIC.
  - `recipient_iban` string — The recipient's IBAN.
  - `recipient_name` string — The recipient's full name.
  - `receiver_iban_virtual` string — (If applicable) The receiver's virtual IBAN.
  - `sender_bic` string — The sender's BIC.
  - `sender_iban` string — The sender's IBAN.
  - `sender_name` string — The sender's full name.
  - `end_to_end_id` string — SEPA identifier provided by the customer who initiated the SEPA transaction, routed through the entire payment process.
  - `creditor_identifier` string — Unique reference that identifies a party collecting payments under the SEPA Direct Debit scheme within and across 32 countries. See the [Deutsche Bundesbank's definition of creditor identifier](https://www.bundesbank.de/en/tasks/payment-systems/services/sepa/creditor-identifier/creditor-identifier-626704) for more information.
  - `mandate_reference` string — The reference of the SDD mandate.
  - `transaction_id` string — The Solaris transaction ID.
  - `return_transaction_id` string — (If applicable) The Solaris ID of the return transaction.
  - `sepa_charges` SolarisResourcesMoneyWithUnit
    - `value` integer — The amount.
    - `unit` string — Money unit used to represent the amount.
    - `currency` string — The currency in which the amount is represented.
  - `sepa_return_code` 'AC01' | 'AC03' | 'AC04' | 'AC06' | 'AC13' | 'AC14' | 'AG01' | 'AG02' | 'AM01' | 'AM02' | 'AM03' | 'AM04' | 'AM05' | 'AM06' | 'AM07' | 'AM09' | 'AM10' | 'ARDT' | 'BE01' | 'BE04' | 'BE05' | 'BE06' | 'BE07' | 'BE08' | 'CNOR' | 'CURR' | 'CUST' | 'DNOR' | 'DS28' | 'DT01' | 'ED01' | 'ED03' | 'ED05' | 'EMVL' | 'FF05' | 'FOCR' | 'FR01' | 'FRTR' | 'MD01' | 'MD02' | 'MD06' | 'MD07' | 'MS02' | 'MS03' | 'NARR' | 'NOAS' | 'NOOR' | 'PINL' | 'RC01' | 'RC07' | 'RF01' | 'RR01' | 'RR02' | 'RR03' | 'RR04' | 'RUTA' | 'SL01' | 'SL02' | 'SL11' | 'SL12' | 'SL13' | 'SL14' | 'SVNR' | 'TM01' | 'TRAC' | 'UPAY', nullable — (If applicable) The SEPA reason code for the return transaction. See the [EPC173-14 guidelines](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2019-05/EPC173-14%20v5.0%20Guidance%20on%20Reason%20Codes%20for%20SDD%20R-transactions.pdfttps://www.europeanpaymentscouncil.eu/document-library/guidance-documents/epc-guidance-reason-codes-sepa-direct-debit-r-transactions) for more information.
  - `sepa_return_reason` string — (If applicable) The SEPA return reason text as defined by [ISO 20022](https://en.wikipedia.org/wiki/ISO_20022).
  - `sepa_return_reason_definition` string — (If applicable) Explanation of the SEPA return reason code as defined by [ISO 20022](https://en.wikipedia.org/wiki/ISO_20022).
  - `meta_info` string — JSON-serialized supplementary information about the transaction. For example, information about the card and the merchant associated with the transaction.
  - `recorded_at` string — UTC timestamp from when the booking was recorded.
  - `reconciliation_id` string — (If applicable) Unique ID of the related clearing transaction initiated by Solaris.
  - `initiator_reference` string — Unique reference for the transaction's initiator.
  - `charge_details` 'DEBT' | 'SHAR' | 'CRED' — Transaction charge details. Only relevant for bookings with the type `TARGET2_CREDIT_TRANSFER`.

## Other responses

- `400` — An error occurred on the client side.
- `404` — The account could not be found.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/account-management.md) · [All operations](https://skmtc.net/solarisgroup/apis/account-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/account-management/revisions/099ef636a5a1/schema)