Delete access with accessId and all related accounts
The id for the access to delete
Retrieve the access with accessId. The retrieved object does not contain sensitive information such as the PIN.
The id for the access to retrieve
Returns all registered accesses for the authenticated user. The access fields contain confidential information (e.g., PIN) that will not be returned.
Create a new access and setup all associated accounts and transactions. This will also trigger the creation of monthly transaction summaries, the analysis of all accounts for recurring transactions, and the calculation of the balance forecast. If the credentials were invalid, the validation state is set accordingly. It is possible to have multiple accesses for one user.
A valid BankAccess object containing the required accessFields as indicated by the provider object and the providerId.
Update the access credentials in accessFields. If the access does not exist, the accessId does not match the id in accessDto, or the providerId is not the same, status code 404 is returned. If another access with the same login data already exists, status code 409 is returned. The updated access is validated by setting up an account. Status code 200 does not imply that the credentials are correct. To check this, the client should obtain access.
The id for the access to update
The access object that contains the changed credentials in accessFields. Other fields cannot be edited.
AccessApi - fetch parameter creator
Delete access with accessId and all related accounts
The id for the access to delete
Retrieve the access with accessId. The retrieved object does not contain sensitive information such as the PIN.
The id for the access to retrieve
Returns all registered accesses for the authenticated user. The access fields contain confidential information (e.g., PIN) that will not be returned.
Create a new access and setup all associated accounts and transactions. This will also trigger the creation of monthly transaction summaries, the analysis of all accounts for recurring transactions, and the calculation of the balance forecast. If the credentials were invalid, the validation state is set accordingly. It is possible to have multiple accesses for one user.
A valid BankAccess object containing the required accessFields as indicated by the provider object and the providerId.
Update the access credentials in accessFields. If the access does not exist, the accessId does not match the id in accessDto, or the providerId is not the same, status code 404 is returned. If another access with the same login data already exists, status code 409 is returned. The updated access is validated by setting up an account. Status code 200 does not imply that the credentials are correct. To check this, the client should obtain access.
The id for the access to update
The access object that contains the changed credentials in accessFields. Other fields cannot be edited.
AccessApi - functional programming interface
Delete access with accessId and all related accounts
The id for the access to delete
Create a new access and setup all associated accounts and transactions. This will also trigger the creation of monthly transaction summaries, the analysis of all accounts for recurring transactions, and the calculation of the balance forecast. If the credentials were invalid, the validation state is set accordingly. It is possible to have multiple accesses for one user.
A valid BankAccess object containing the required accessFields as indicated by the provider object and the providerId.
Update the access credentials in accessFields. If the access does not exist, the accessId does not match the id in accessDto, or the providerId is not the same, status code 404 is returned. If another access with the same login data already exists, status code 409 is returned. The updated access is validated by setting up an account. Status code 200 does not imply that the credentials are correct. To check this, the client should obtain access.
The id for the access to update
The access object that contains the changed credentials in accessFields. Other fields cannot be edited.
AccountApi - factory interface
Delete the account identified by accountId
The accessId for the account to delete
The id for the account to delete
Returns the account identified by accountId
The accessId for the account to retrieve
The id for the account to retrieve
Retrieve all accounts for the current user under the accessId
The id for the access for which to retrieve all accounts
Update the account name used in AHOI. Name must be URL encoded.
The accessId for which the user-defined account name should be altered
The id for which the user-defined account name should be altered
The new URL-encoded name
AccountApi - fetch parameter creator
Delete the account identified by accountId
The accessId for the account to delete
The id for the account to delete
Returns the account identified by accountId
The accessId for the account to retrieve
The id for the account to retrieve
Retrieve all accounts for the current user under the accessId
The id for the access for which to retrieve all accounts
Update the account name used in AHOI. Name must be URL encoded.
The accessId for which the user-defined account name should be altered
The id for which the user-defined account name should be altered
The new URL-encoded name
AccountApi - functional programming interface
Delete the account identified by accountId
The accessId for the account to delete
The id for the account to delete
Update the account name used in AHOI. Name must be URL encoded.
The accessId for which the user-defined account name should be altered
The id for which the user-defined account name should be altered
The new URL-encoded name
CategoryApi - factory interface
Supported origins are: FINLYTICS
identifier of a supported origin
CategoryApi - fetch parameter creator
Supported origins are: FINLYTICS
identifier of a supported origin
CategoryApi - functional programming interface
ContractApi - fetch parameter creator
api.resource.contracts.getContractList.description
ContractApi - functional programming interface
ForecastApi - factory interface
The current month is determined by the most recent refresh.
The accessId for which to retrieve forecasts
The accountId for which to retrieve forecasts
The current month is determined by the most recent refresh of transactions. The request also retrieves the transactions expected to be applied until the end of the current month.
The accessId for the forecast
The id for the account
ForecastApi - fetch parameter creator
The current month is determined by the most recent refresh.
The accessId for which to retrieve forecasts
The accountId for which to retrieve forecasts
The current month is determined by the most recent refresh of transactions. The request also retrieves the transactions expected to be applied until the end of the current month.
The accessId for the forecast
The id for the account
ForecastApi - functional programming interface
The current month is determined by the most recent refresh.
The accessId for which to retrieve forecasts
The accountId for which to retrieve forecasts
The current month is determined by the most recent refresh of transactions. The request also retrieves the transactions expected to be applied until the end of the current month.
The accessId for the forecast
The id for the account
ProviderApi - factory interface
Retrieve a single provider identified by providerId
The providerId to retrieve
Retrieve a list of bank providers. A providerid is required to create an access. To retrieve the necessary access fields, you need to query the specific provider/{providerId}
. For performance reasons they are kept separate.
ProviderApi - fetch parameter creator
Retrieve a single provider identified by providerId
The providerId to retrieve
Retrieve a list of bank providers. A providerid is required to create an access. To retrieve the necessary access fields, you need to query the specific provider/{providerId}
. For performance reasons they are kept separate.
ProviderApi - functional programming interface
Retrieve a list of bank providers. A providerid is required to create an access. To retrieve the necessary access fields, you need to query the specific provider/{providerId}
. For performance reasons they are kept separate.
QuickStartApi - factory interface
Retrieve a single provider identified by providerId
The providerId to retrieve
Retrieve a list of bank providers. A providerid is required to create an access. To retrieve the necessary access fields, you need to query the specific provider/{providerId}
. For performance reasons they are kept separate.
Create a new access and setup all associated accounts and transactions. This will also trigger the creation of monthly transaction summaries, the analysis of all accounts for recurring transactions, and the calculation of the balance forecast. If the credentials were invalid, the validation state is set accordingly. It is possible to have multiple accesses for one user.
A valid BankAccess object containing the required accessFields as indicated by the provider object and the providerId.
Registers a user with AHOI
QuickStartApi - fetch parameter creator
Retrieve a single provider identified by providerId
The providerId to retrieve
Retrieve a list of bank providers. A providerid is required to create an access. To retrieve the necessary access fields, you need to query the specific provider/{providerId}
. For performance reasons they are kept separate.
Create a new access and setup all associated accounts and transactions. This will also trigger the creation of monthly transaction summaries, the analysis of all accounts for recurring transactions, and the calculation of the balance forecast. If the credentials were invalid, the validation state is set accordingly. It is possible to have multiple accesses for one user.
A valid BankAccess object containing the required accessFields as indicated by the provider object and the providerId.
Registers a user with AHOI
QuickStartApi - functional programming interface
Retrieve a list of bank providers. A providerid is required to create an access. To retrieve the necessary access fields, you need to query the specific provider/{providerId}
. For performance reasons they are kept separate.
Create a new access and setup all associated accounts and transactions. This will also trigger the creation of monthly transaction summaries, the analysis of all accounts for recurring transactions, and the calculation of the balance forecast. If the credentials were invalid, the validation state is set accordingly. It is possible to have multiple accesses for one user.
A valid BankAccess object containing the required accessFields as indicated by the provider object and the providerId.
Registers a user with AHOI
RegistrationApi - factory interface
api.resource.registration.deleteRegistration.description
A valid API public key will be returned in JWK format to be used to encrypt registration data. Only needed with extended encryption.
A valid API public key will be returned to be used to encrypt registration data. Only needed with extended encryption.
Registers a user with AHOI
RegistrationApi - fetch parameter creator
api.resource.registration.deleteRegistration.description
A valid API public key will be returned in JWK format to be used to encrypt registration data. Only needed with extended encryption.
A valid API public key will be returned to be used to encrypt registration data. Only needed with extended encryption.
Registers a user with AHOI
RegistrationApi - functional programming interface
api.resource.registration.deleteRegistration.description
A valid API public key will be returned in JWK format to be used to encrypt registration data. Only needed with extended encryption.
A valid API public key will be returned to be used to encrypt registration data. Only needed with extended encryption.
Registers a user with AHOI
SecurityApi - factory interface
api.resource.accesses.accessId.accounts.accountId.securities.securityId.getSecurity.description
api.resource.accesses.accessId.accounts.accountId.securities.securityId.getSecurity.parameter.accessId.description
The accountId for which to retrieve securities
The securityId for the security to retrieve
api.resource.accesses.accessId.accounts.accountId.securities.listSecurities.description
api.resource.accesses.accessId.accounts.accountId.securities.listSecurities.parameter.accessId.description
The accountId for which to retrieve securities
SecurityApi - fetch parameter creator
api.resource.accesses.accessId.accounts.accountId.securities.securityId.getSecurity.description
api.resource.accesses.accessId.accounts.accountId.securities.securityId.getSecurity.parameter.accessId.description
The accountId for which to retrieve securities
The securityId for the security to retrieve
api.resource.accesses.accessId.accounts.accountId.securities.listSecurities.description
api.resource.accesses.accessId.accounts.accountId.securities.listSecurities.parameter.accessId.description
The accountId for which to retrieve securities
SecurityApi - functional programming interface
api.resource.accesses.accessId.accounts.accountId.securities.securityId.getSecurity.description
api.resource.accesses.accessId.accounts.accountId.securities.securityId.getSecurity.parameter.accessId.description
The accountId for which to retrieve securities
The securityId for the security to retrieve
api.resource.accesses.accessId.accounts.accountId.securities.listSecurities.description
api.resource.accesses.accessId.accounts.accountId.securities.listSecurities.parameter.accessId.description
The accountId for which to retrieve securities
TANSchemesApi - factory interface
Returns the currently selected TAN media for the access
The accessId for which to retrieve the current TAN media
Returns the currently selected TAN scheme for the access
The accessId for which to retrieve the current TAN scheme
Retrieves all available TAN schemes for access
The id for the access for which to retrieve the TAN list
Update the access with a new currentTanMedia
The accessId for which to set the current TAN media
The id for the TAN media that should be set as the new currentTanMedia
Update the access with a new currentTanScheme
The accessId for which to set the current TAN scheme
The id for the TAN scheme that should be set as the new currentTanScheme
TANSchemesApi - fetch parameter creator
Returns the currently selected TAN media for the access
The accessId for which to retrieve the current TAN media
Returns the currently selected TAN scheme for the access
The accessId for which to retrieve the current TAN scheme
Retrieves all available TAN schemes for access
The id for the access for which to retrieve the TAN list
Update the access with a new currentTanMedia
The accessId for which to set the current TAN media
The id for the TAN media that should be set as the new currentTanMedia
Update the access with a new currentTanScheme
The accessId for which to set the current TAN scheme
The id for the TAN scheme that should be set as the new currentTanScheme
TANSchemesApi - functional programming interface
Update the access with a new currentTanMedia
The accessId for which to set the current TAN media
The id for the TAN media that should be set as the new currentTanMedia
Update the access with a new currentTanScheme
The accessId for which to set the current TAN scheme
The id for the TAN scheme that should be set as the new currentTanScheme
TaskApi - factory interface
This is the third required step when executing a TAN-aware banking task (e.g., a SEPA transfer).
The id of the task
Use this to poll for status changes (e.g., steps two and five of the SEPA transfer process) or to query the state after receiving a callback from AHOI.
The id of the task for which to retrieve the status.
The SEPA transfer initiated using the Transfer resource requires this starting with step four.
The id of the task
The response to process
TaskApi - fetch parameter creator
This is the third required step when executing a TAN-aware banking task (e.g., a SEPA transfer).
The id of the task
Use this to poll for status changes (e.g., steps two and five of the SEPA transfer process) or to query the state after receiving a callback from AHOI.
The id of the task for which to retrieve the status.
The SEPA transfer initiated using the Transfer resource requires this starting with step four.
The id of the task
The response to process
TaskApi - functional programming interface
Use this to poll for status changes (e.g., steps two and five of the SEPA transfer process) or to query the state after receiving a callback from AHOI.
The id of the task for which to retrieve the status.
The SEPA transfer initiated using the Transfer resource requires this starting with step four.
The id of the task
The response to process
TransactionApi - factory interface
Returns the transaction identified by transactionId in relation to accountId.
The accessId for the transaction to retrieve
The accountId for the transaction to retrieve
The transactionId for the pattern to retrieve
Retrieve all transactions for accountId
The accessId for which to retrieve transactions
The accountId for which to retrieve transactions
Retrieve all transactions for patternId
The accessId for which to retrieve transactions
The accountId for which to retrieve transactions
The patternId for which to retrieve transactions
TransactionApi - fetch parameter creator
Returns the transaction identified by transactionId in relation to accountId.
The accessId for the transaction to retrieve
The accountId for the transaction to retrieve
The transactionId for the pattern to retrieve
Retrieve all transactions for accountId
The accessId for which to retrieve transactions
The accountId for which to retrieve transactions
Retrieve all transactions for patternId
The accessId for which to retrieve transactions
The accountId for which to retrieve transactions
The patternId for which to retrieve transactions
TransactionApi - functional programming interface
Returns the transaction identified by transactionId in relation to accountId.
The accessId for the transaction to retrieve
The accountId for the transaction to retrieve
The transactionId for the pattern to retrieve
Retrieve all transactions for accountId
The accessId for which to retrieve transactions
The accountId for which to retrieve transactions
Retrieve all transactions for patternId
The accessId for which to retrieve transactions
The accountId for which to retrieve transactions
The patternId for which to retrieve transactions
TransactionPatternApi - factory interface
Disabling the transaction pattern results in ignoring the pattern in the forecast. The transaction pattern still exists and relationships to transactions are not modified.
The accessId for which to activate the pattern
The accountId for which to activate the pattern
The patternId to (de)activate
If `true`, the pattern will be used for forecast calculations; `false` will be ignored.
Delete the transaction pattern identified by the patternId. All associated transactions will be updated to {{patternId = null}}.
The accessId for the transaction pattern to delete
The accountId for the transaction pattern to delete
The patternId to delete
Returns the transaction pattern identified by patternId in relation to accountId.
The accessId for the pattern to retrieve
The accoundId for the pattern to retrieve
The patternId for the pattern to retrieve
Returns all transaction patterns for accountId. Transaction patterns are recurring transactions automatically identified by the server or manually created via create transaction pattern.
The accessId for which to retrieve transaction patterns
The accountId for which to retrieve transaction patterns
Create a new pattern for an accountId. The cycle can be MONTHLY
, QUARTERLY
, SEMI_ANNUALLY
or ANNUALLY
. The day can be between 1
and 366
, depending on cycle: | cycle | day range | example | | --- | --- | --- | | MONTHLY
| 1
-31
| every 29th of the month => 29
| | QUARTERLY
| 1
-92
| 23rd of February (23rd of May, etc.) => 54
(31 [complete first month] + 23 [days in second month]) | | SEMI_ANNUALLY
| 1
-184
| 1st of May and 1st of November => 121
(for first half of year: 31 + 28 + 31 + 30 + 1) | | ANNUALLY
| 1
-366
| 24th of December => 358
| If a similar pattern already exists, you will receive an HTTP status code 409.
The accessId with which the newly created pattern is associated
The accountId with which the newly created pattern is associated
The transaction pattern to create
TransactionPatternApi - fetch parameter creator
Disabling the transaction pattern results in ignoring the pattern in the forecast. The transaction pattern still exists and relationships to transactions are not modified.
The accessId for which to activate the pattern
The accountId for which to activate the pattern
The patternId to (de)activate
If `true`, the pattern will be used for forecast calculations; `false` will be ignored.
Delete the transaction pattern identified by the patternId. All associated transactions will be updated to {{patternId = null}}.
The accessId for the transaction pattern to delete
The accountId for the transaction pattern to delete
The patternId to delete
Returns the transaction pattern identified by patternId in relation to accountId.
The accessId for the pattern to retrieve
The accoundId for the pattern to retrieve
The patternId for the pattern to retrieve
Returns all transaction patterns for accountId. Transaction patterns are recurring transactions automatically identified by the server or manually created via create transaction pattern.
The accessId for which to retrieve transaction patterns
The accountId for which to retrieve transaction patterns
Create a new pattern for an accountId. The cycle can be MONTHLY
, QUARTERLY
, SEMI_ANNUALLY
or ANNUALLY
. The day can be between 1
and 366
, depending on cycle: | cycle | day range | example | | --- | --- | --- | | MONTHLY
| 1
-31
| every 29th of the month => 29
| | QUARTERLY
| 1
-92
| 23rd of February (23rd of May, etc.) => 54
(31 [complete first month] + 23 [days in second month]) | | SEMI_ANNUALLY
| 1
-184
| 1st of May and 1st of November => 121
(for first half of year: 31 + 28 + 31 + 30 + 1) | | ANNUALLY
| 1
-366
| 24th of December => 358
| If a similar pattern already exists, you will receive an HTTP status code 409.
The accessId with which the newly created pattern is associated
The accountId with which the newly created pattern is associated
The transaction pattern to create
TransactionPatternApi - functional programming interface
Disabling the transaction pattern results in ignoring the pattern in the forecast. The transaction pattern still exists and relationships to transactions are not modified.
The accessId for which to activate the pattern
The accountId for which to activate the pattern
The patternId to (de)activate
If `true`, the pattern will be used for forecast calculations; `false` will be ignored.
Delete the transaction pattern identified by the patternId. All associated transactions will be updated to {{patternId = null}}.
The accessId for the transaction pattern to delete
The accountId for the transaction pattern to delete
The patternId to delete
Returns the transaction pattern identified by patternId in relation to accountId.
The accessId for the pattern to retrieve
The accoundId for the pattern to retrieve
The patternId for the pattern to retrieve
Returns all transaction patterns for accountId. Transaction patterns are recurring transactions automatically identified by the server or manually created via create transaction pattern.
The accessId for which to retrieve transaction patterns
The accountId for which to retrieve transaction patterns
Create a new pattern for an accountId. The cycle can be MONTHLY
, QUARTERLY
, SEMI_ANNUALLY
or ANNUALLY
. The day can be between 1
and 366
, depending on cycle: | cycle | day range | example | | --- | --- | --- | | MONTHLY
| 1
-31
| every 29th of the month => 29
| | QUARTERLY
| 1
-92
| 23rd of February (23rd of May, etc.) => 54
(31 [complete first month] + 23 [days in second month]) | | SEMI_ANNUALLY
| 1
-184
| 1st of May and 1st of November => 121
(for first half of year: 31 + 28 + 31 + 30 + 1) | | ANNUALLY
| 1
-366
| 24th of December => 358
| If a similar pattern already exists, you will receive an HTTP status code 409.
The accessId with which the newly created pattern is associated
The accountId with which the newly created pattern is associated
The transaction pattern to create
TransactionSummaryApi - factory interface
Retrieve account summaries and provide a sum for incoming and outgoing transactions
The accessId for which to list the summaries
The accountId for which to list the summaries
TransactionSummaryApi - fetch parameter creator
Retrieve account summaries and provide a sum for incoming and outgoing transactions
The accessId for which to list the summaries
The accountId for which to list the summaries
TransactionSummaryApi - functional programming interface
Retrieve account summaries and provide a sum for incoming and outgoing transactions
The accessId for which to list the summaries
The accountId for which to list the summaries
TransferApi - factory interface
**Please note:**
The id of the access corresponding to accounts to be used
The id for the account
Transfer to create
TransferApi - fetch parameter creator
**Please note:**
The id of the access corresponding to accounts to be used
The id for the account
Transfer to create
TransferApi - functional programming interface
**Please note:**
The id of the access corresponding to accounts to be used
The id for the account
Transfer to create
AccessApi - factory interface