Accounts

Get account bookings

Returns an array containing all bookings for an account.

get/v1/accounts/{account_id}/bookings

Path parameters

account_idstring 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'booking_date' | 'valuta_date' | 'recorded_at' | 'id'

Sort the results by booking_date, valuta_date, recorded_at, or 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 starting from a certain date and time.

filter[recorded_at][max]string

Filter the results by the date and time when the booking was recorded up until 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

The operation was successful.

idstring

ID of the booking.

creation_datestring

The date when the booking was created. Do not expose this to the account holder(s).

valuta_datestring

The valuta date of the booking (i.e., the date when the booking becomes effective).

booking_datestring

The date when the booking was posted.

The type of the booking. See the booking documentation for a list of explanations for each booking type.

descriptionstring

A description of the booking.

purpose_codestring

The purpose code of the booking.

recipient_bicstring

The recipient's BIC.

recipient_ibanstring

The recipient's IBAN.

recipient_namestring

The recipient's full name.

receiver_iban_virtualstring

(If applicable) The receiver's virtual IBAN.

sender_bicstring

The sender's BIC.

sender_ibanstring

The sender's IBAN.

sender_namestring

The sender's full name.

end_to_end_idstring

SEPA identifier provided by the customer who initiated the SEPA transaction, routed through the entire payment process.

creditor_identifierstring

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 for more information.

mandate_referencestring

The reference of the SDD mandate.

transaction_idstring

The Solaris transaction ID.

return_transaction_idstring

(If applicable) The Solaris ID of the return transaction.

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 for more information.

sepa_return_reasonstring

(If applicable) The SEPA return reason text as defined by ISO 20022.

sepa_return_reason_definitionstring

(If applicable) Explanation of the SEPA return reason code as defined by ISO 20022.

meta_infostring

JSON-serialized supplementary information about the transaction. For example, information about the card and the merchant associated with the transaction.

recorded_atstring

UTC timestamp from when the booking was recorded.

reconciliation_idstring

(If applicable) Unique ID of the related clearing transaction initiated by Solaris.

initiator_referencestring

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.

Example response

[
  {
    "id": "fe6561bdb526ed8866e9dac00bd1848ecboo",
    "creation_date": "2022-01-18",
    "valuta_date": "2022-01-18",
    "booking_date": "2022-01-18",
    "booking_type": "SEPA_CREDIT_TRANSFER",
    "amount": {
      "value": 5000,
      "unit": "cents",
      "currency": "EUR"
    },
    "description": "BERLINER VOLKSBANK EG, TXL ABFLUG",
    "purpose_code": "null",
    "recipient_bic": "SOBKDEBBXXX",
    "recipient_iban": "DE97110101002242911754",
    "recipient_name": "SURIA LUIS VENTURA VIERA PEREIRA RIBEIRO",
    "sender_bic": "SOBKDEBBXXX",
    "sender_iban": "DE95110101000018501020",
    "sender_name": "HANS MUSTERMANN",
    "end_to_end_id": "END2ENDREJ",
    "creditor_identifier": "DE98ZZZ09999999999",
    "mandate_reference": "00000000000001",
    "transaction_id": "d651ee23300b4e7c8fe7b7e2b2e96trx",
    "return_transaction_id": "758ea4a268974284ae7af17871f3fdc4",
    "sepa_charges": {
      "value": 5000,
      "unit": "cents",
      "currency": "EUR"
    },
    "meta_info": "{\"cards\":{\"card_id\":\"abe6963e8be94364b8c1aa34d1bb5bc3mcrd\",\"merchant\":{\"id\":\"123456789101112\",\"country_code\":\"GB\",\"category_code\":\"5411\",\"name\":\"Grocery\",\"town\":\"London\"},\"original_amount\":{\"currency\":\"GBP\",\"value\":50000,\"fx_rate\":10.0,\"fx_markup\":7.3165,\"issuer_fee\":0.0},\"pos_entry_mode\":\"MANUAL_PAN_ENTRY\",\"trace_id\":\"382621b66280020528d9433d135c2ae418fa53d0\",\"transaction_id\":\"c158f11c-d6b2-4f8f-9391-ac20c2167f89\",\"transaction_date\":\"2024-10-18\",\"transaction_time\":\"2024-10-18T15:22:02+00:00\",\"auth_code\":\"053630\",\"acquirer_id\":\"123456\",\"terminal_id\":\"12345678\",\"transaction_type\":\"PURCHASE\"}}",
    "recorded_at": "2022-01-24T00:41:57.634Z",
    "reconciliation_id": "87271dda6e454393036b4ec2b64b2221itrx",
    "charge_details": "CRED"
  }
]