XSxs2a
XS2A.api.accounts

Retrieve the turnovers for a specific bank account

Changed on
get/api/accounts/{bank-account-id}/turnovers

Request

Path parameters

bank-account-idstring required

The bank-account-id for the account for which the turnovers are to be retrieved.

Query parameters

fromstring date
Example:2019-02-14

Filter turnovers by booking_date.

tostring date
Example:2019-02-22

Filter turnovers by booking_date.

only_newboolean
Example:true

Filter turnovers by new flag.

Response

Request successfully processed

idstring

Bank Account ID

daysinteger

The number of days requested

datestring

The date the turnovers were seen on.

created_atstring

Date of creation of the turnovers object.

objectstring

The value bank_account_turnovers

Example response

{
  "id": "bac_c8KYwjexO2iO5AE9",
  "turnovers": [
    {
      "booking_date": "2017-10-08T00:00:00Z",
      "amount": -962,
      "currency_id": "EUR",
      "purpose": [
        "SEPA-DAUERAUFTRAG EMPFAENGER HAUSVERWALTUNG"
      ],
      "counter_iban": "DE18701693100100029394",
      "counter_bic": "GENODEF1ALX",
      "counter_holder": "MUSTERMANN, HARTMUT",
      "canceled": true,
      "tags": [
        "expenditure"
      ],
      "category_id": "K.1.2",
      "creditor_id": "LU96ZZZ0000000000000000058",
      "new": true,
      "transaction_id": "8943aefb-ec2b-46fa-8a38-dc264af13eb3",
      "booking_text": "LASTSCHRIFT",
      "purpose_code": "SALA",
      "reason_code": "RUECKLASTSCHRIFT Rueckgabe mangels Deckung",
      "mandate_id": "MRN1234567890",
      "endToEnd_id": "LO-123-1234567890",
      "bank_transaction_code": "PMNT",
      "swift_transaction_code": "NTRF+153+00931"
    }
  ],
  "days": 59,
  "date": "2017-12-06T00:00:00Z",
  "created_at": "2018-03-16 11:14:58",
  "object": "bank_account_turnovers"
}

Changes

  • ae5fbc5feee3Revision changes
    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status