# Get account bookings

Returns an array containing all bookings for an account.

Endpoint: GET /v1/accounts/{account_id}/bookings
Version: 1.0

## Path parameters:

  - `account_id` (string, required)

## Query parameters:

  - `page[number]` (string)
    The number of results pages to return.

  - `page[size]` (string)
    The size of each page in the response.

  - `sort` (string)
    Sort the results by , , , or .
    Enum: "booking_date", "valuta_date", "recorded_at", "id"

  - `filter[id]` (string)
    ID of the booking.

  - `filter[recorded_at][min]` (string)
    Filter the results by the date and time when the booking was recorded  a certain date and time.

  - `filter[recorded_at][max]` (string)
    Filter the results by the date and time when the booking was recorded  a certain date and time.

  - `filter[valuta_date]` (string)
    Filter the results by the valuta date.

  - `filter[booking_type]` (string)
    Filter the results by booking type.

  - `filter[description]` (string)
    Filter the results by booking description.

  - `filter[receiver_iban_virtual]` (string)
    Filter the results to show bookings received on virtual IBANs.

  - `filter[transaction_id]` (string)
    Filter the results by transaction ID.

## Response 200 fields (application/json):

  - `id` (string)
    ID of the booking.
    Example: "fe6561bdb526ed8866e9dac00bd1848ecboo"

  - `creation_date` (string)
    The date when the booking was created. Do not expose this to the account holder(s).
    Example: "2022-01-18"

  - `valuta_date` (string)
    The valuta date of the booking (i.e., the date when the booking becomes effective).
    Example: "2022-01-18"

  - `booking_date` (string)
    The date when the booking was posted.
    Example: "2022-01-18"

  - `booking_type` (string)
    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.
    Enum: "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"

  - `amount` (object)
    The amount of the booking.
    Example: {"value":-160,"unit":"cents","currency":"EUR"}

  - `amount.value` (integer)
    The amount.
    Example: -160

  - `amount.unit` (string)
    Money unit used to represent the amount.
    Example: "cents"

  - `amount.currency` (string)
    The currency in which the amount is represented.
    Example: "EUR"

  - `description` (string)
    A description of the booking.
    Example: "BERLINER VOLKSBANK EG, TXL ABFLUG"

  - `purpose_code` (string)
    The purpose code of the booking.
    Example: "null"

  - `recipient_bic` (string)
    The recipient's BIC.
    Example: "SOBKDEBBXXX"

  - `recipient_iban` (string)
    The recipient's IBAN.
    Example: "DE97110101002242911754"

  - `recipient_name` (string)
    The recipient's full name.
    Example: "SURIA LUIS VENTURA VIERA PEREIRA RIBEIRO"

  - `receiver_iban_virtual` (string)
    (If applicable) The receiver's virtual IBAN.

  - `sender_bic` (string)
    The sender's BIC.
    Example: "SOBKDEBBXXX"

  - `sender_iban` (string)
    The sender's IBAN.
    Example: "DE95110101000018501020"

  - `sender_name` (string)
    The sender's full name.
    Example: "HANS MUSTERMANN"

  - `end_to_end_id` (string)
    SEPA identifier provided by the customer who initiated the SEPA transaction, routed through the entire payment process.
    Example: "END2ENDREJ"

  - `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.
    Example: "DE98ZZZ09999999999"

  - `mandate_reference` (string)
    The reference of the SDD mandate.
    Example: "00000000000001"

  - `transaction_id` (string)
    The Solaris transaction ID.
    Example: "d651ee23300b4e7c8fe7b7e2b2e96trx"

  - `return_transaction_id` (string)
    (If applicable) The Solaris ID of the return transaction.
    Example: "758ea4a268974284ae7af17871f3fdc4"

  - `sepa_charges` (object)
    (If applicable) Object containing information about the SEPA Direct Debit return transaction charges.

  - `sepa_return_code` (string,null)
    (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.
    Enum: "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"

  - `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` (object,null)

  - `recorded_at` (string)
    UTC timestamp from when the booking was recorded.
    Example: "2022-01-24T00:41:57.634Z"

  - `reconciliation_id` (string)
    (If applicable) Unique ID of the related clearing transaction initiated by Solaris.
    Example: "87271dda6e454393036b4ec2b64b2221itrx"

  - `initiator_reference` (string)
    Unique reference for the transaction's initiator.

  - `charge_details` (string)
    Transaction charge details. Only relevant for bookings with the type .
    Enum: "DEBT", "SHAR", "CRED"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Account' for id 'DE24112233445566'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."