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 execution date (inclusive greater than), in ISO8601 format.

  • end_date string(date-time)

    Filter transactions by execution 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.

  • Filter transactions by custom ID.

  • order_by string

    Sort transactions in ascending or descending order.

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

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • results array[object] Required

      Elements of the page.

      Hide results attributes Show results attributes object
      • 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.

      • local_iban string Required

        IBAN through which this transaction got in or out of the account. Can be the main IBAN of the account or a virtual IBAN.

      • 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.

      • Custom identifier attached to the transaction. It is not transmitted nor visible in your Memo Bank workspace. It can only be retrieved or used to search for transactions via Memo Bank API.

      • Custom metadata attached to the transaction. It is not transmitted nor visible in your Memo Bank workspace and can only be retrieved via API.

      • 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 examples (200)
{
  "results": [
    {
      "id": "fe98f29d-5165-45ff-83f9-d7aa83e970b5",
      "reference": "fe98f29d-5165-45ff-83f9-d7aa83e970b5",
      "account_id": "708683cb-60f6-464a-a62f-be2e339c34aa",
      "amount": 42,
      "local_iban": "FR27590171083068762111832788",
      "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",
      "custom_id": "637406efda8534de8c0e",
      "custom_metadata": "This is some metadata",
      "attachment_count": 42,
      "source": {
        "type": "bank_account_remuneration"
      }
    }
  ],
  "has_prev": true,
  "has_next": true
}