List all transactions

GET /v2/transactions

Query parameters

  • account_id string(uuid)

    Filter transactions by account.

  • page integer(int32)

    Index of the requested page.

    Minimum value is 1. Default value is 1.

  • size integer(int32)

    Number of elements per page in response.

    Minimum value is 1, maximum value is 100. Default value is 10.

  • start_date string(date-time)

    Filter transactions by accounting date (inclusive greater than), in ISO8601 format.

  • end_date string(date-time)

    Filter transactions by accounting date (exclusive lower than), in ISO8601 format.

  • reference string(uuid)

    Filter transactions by reference.

  • Filter transactions by local IBAN. Allows for example to list all incoming and outgoing transactions that passed through a given virtual IBAN.

  • batch_id string(uuid)

    Filter transactions by transaction batch.

  • order_by string

    Sort transactions in ascending or descending order.

    Values are execution_date or -execution_date. Default value is -execution_date.

Responses

  • 200 object

    OK

    • results array[object] Required

      Elements of the page.

      • id string(uuid) Required

        Unique ID of the transaction.

      • reference string(uuid) Required

        Reference of the money movement. In case you initiate a transfer between two of your own accounts, both transactions (debit and credit) will have the same reference, it can be safely used to correlate them.

      • account_id string(uuid) Required

        ID of the account this transaction belongs to.

      • amount integer(int64) Required

        Amount of the transaction, in cents. The amount is always positive, use direction to give it a sign.

      • currency string Required

        Currency of the transaction amount, in ISO 4217 format.

      • direction string Required

        Direction of the transaction.

        Values are debit or credit.

      • request_date string(date-time) Required

        Date at which the transaction has been requested, in ISO8601 format.Usually the same as the execution date, except for scheduled transfers and transfer requests.

      • execution_date string(date-time) Required

        Date at which the transaction processing has started or will start, in ISO8601 format. For debits, that’s when the money is removed from the available balance of the account.

      • accounting_date string(date-time)

        Date at which the transaction has been confirmed, in ISO8601 format. For credits, that’s when the money is credited from the available balance of the account.

      • counterparty_name string Required

        Name of the counterparty.

      • Internal note attached to this transaction, visible only in your Memo Bank workspace.

      • status string Required

        Current status of the transaction.

        Values are scheduled, authorized, confirmed, rejected, or canceled.

      • batch_id string(uuid)

        ID of the batch this transaction belongs to, if any.

      • attachment_count integer(int32)

        Number of documents attached to this transaction.

      • source object Required
        One of:
    • has_prev boolean Required

      Flag indicating if there is a previous page.

    • has_next boolean Required

      Flag indicating if there is a next page.

GET /v2/transactions
curl \
 -X GET https://api.memo.bank/v2/transactions \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response example (200)
{
  "results": [
    {
      "id": "fe98f29d-5165-45ff-83f9-d7aa83e970b5",
      "reference": "fe98f29d-5165-45ff-83f9-d7aa83e970b5",
      "account_id": "708683cb-60f6-464a-a62f-be2e339c34aa",
      "amount": 42,
      "currency": "EUR",
      "direction": "debit",
      "request_date": "2023-05-04T09:42:00+00:00",
      "execution_date": "2023-05-04T09:42:00+00:00",
      "accounting_date": "2023-05-04T09:42:00+00:00",
      "counterparty_name": "string",
      "internal_note": "phone bill",
      "status": "scheduled",
      "batch_id": "dc47b1ee-1bd7-4072-8d1b-27ff4297b33e",
      "attachment_count": 42,
      "source": {
        "type": "bank_account_remuneration"
      }
    }
  ],
  "has_prev": true,
  "has_next": true
}