1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76
|
Reading operations
==================
.. note::
Starting from version 3, **all of the methods on this page** can return a ``NeedTANResponse`` instead of actual
data if your bank requires a TAN. You should then enter a TAN, read our chapter :ref:`tans` to find out more.
Fetching your bank accounts
---------------------------
The most simple method allows you to get all bank accounts that your user has access to:
.. autoclass:: fints.client.FinTS3Client
:noindex:
:members: get_sepa_accounts
This method will return a list of named tuples of the following type:
.. autoclass:: fints.models.SEPAAccount
You will need this account object for many further operations to show which account you want to operate on.
.. _information:
Fetching bank information
-------------------------
During the first interaction with the bank some meta information about the bank and your user is transmitted
from the bank.
.. autoclass:: fints.client.FinTS3Client
:members: get_information
:noindex:
Fetching account balances
-------------------------
You can fetch the current balance of an account with the ``get_balance`` operation.
.. autoclass:: fints.client.FinTS3Client
:members: get_balance
:noindex:
This method will return a list of ``Balance`` objects from the ``mt-940`` library. You can find more information
in `their documentation <https://mt940.readthedocs.io/en/latest/mt940.html#mt940.models.Balance>`_.
.. _transactions:
Reading account transactions
----------------------------
You can fetch the banking statement of an account within a certain timeframe with the ``get_transactions``
operation.
.. autoclass:: fints.client.FinTS3Client
:members: get_transactions, get_transactions_xml
:noindex:
This method will return a list of ``Transaction`` objects from the ``mt-940`` library. You can find more information
in `their documentation <https://mt940.readthedocs.io/en/latest/mt940.html#mt940.models.Transaction>`_.
Fetching holdings
-----------------
You can fetch the holdings of an account with the ``get_holdings`` method:
.. autoclass:: fints.client.FinTS3Client
:members: get_holdings
:noindex:
This method will return a list of ``Holding`` objects:
.. autoclass:: fints.models.Holding
|