Account Info Report

This report shows all details about an account.

URL and Request Body Structure of an Account Info Report

POST /insights/v1/reports/account-info/create HTTP/1.1
Content-Type: application/json; charset=utf-8
Authorization: Token <Token>
Host: <Host>

{
    "insights_consumer_id": String,
    "insights_account_ids": ?Array<String>,
    "excluded_insights_account_ids": ?Array<String>
}

insights_consumer_id String, required

The insights_consumer_id parameter identifies the consumer whose transactions are used to generate the report.

insights_account_ids String[], optional

The list of accounts, identified by the insights_account_id, which will filter all transactions from the consumer to only those accounts. If missing, all accounts of the insights_consumer_id will be used to generate the report(s). The insights_account_ids parameter must be empty if the excluded_insights_account_ids parameter is set.

excluded_insights_account_ids String[], optional

The list of insights_account_ids which will be excluded from the report generation. The excluded_insights_account_ids parameter must be empty if the insights_account_ids parameter is set.

Response Structure of Account Info Report

{
    "data": {
        "reports": Array<AccountInfo>
    }
}

data.reports AccountInfo, always present

The list of reports generated depending on the requested parameters.

AccountInfo

{
    "type": "ACCOUNT_INFOS",
    "insights_consumer_id": String,
    "insights_account_ids": Array<String>,
    "account_alias": ?String,
    "holder_name": ?String,
    "currency": ?String,
    "iban": ?String,
    "account_number": ?String,
    "bic": ?String,
    "bank_code": ?String,
    "bank_name": ?String,
    "country": ?String,
    "account_type": ?Enum<'DEFAULT', 'SAVING', 'CREDITCARD', 'DEPOT'>,
    "transfer_type": ?Enum<'NONE', 'DOMESTIC', 'FULL', 'REFERENCE', 'RESTRICTED'>,
    "refreshed_at": DateTime,
    "accounts_group_id": ?String,
    "oldest_transaction_date": ?Date,
    "consent_expected_expiry_date": ?Date,
    "bank_country": ?String,
    "bank_krn": ?String,
    "integration_krn": ?String,
    "sub_integration_krn": ?String,
    "labels": ?{
        <label_key>: String,
    }
}

type String, always present

The type always contains the value "ACCOUNT_INFOS" for this report.

insights_consumer_id String, always present

The insights_consumer_id is the consumer identifier for the account(s) used in this report.

insights_account_ids String, always present

The insights_account_ids is used to identify a specific account within Account Insights. For this report there will always only be a single entry in this list.

account_alias String, optional

An alternative name for the account. A description that the consumer set for this account. It should be displayed if it is set, because the consumer can relate to it.

holder_name String, optional

The account holder name. The format of the string is unknown, as it depends on the bank.

Furthermore, there is no guarantee for the correctness of the name, because some banks allow the consumer to change of the name inside the banking portal.

currency String, optional

The currency according to ISO-4217.

iban String, optional

The IBAN of the account.

account_number String, optional

The account number of the account.

bic String, optional

The BIC of the consumer's bank.

bank_code String, optional

The bank code of the consumer's bank.

bank_name String, optional

The bank name of the consumer's bank.

country String, optional

The country of the account, typically same as where the bank resides.

account_type Enum, optional

Indicates the type of the account.

DEFAULT - A regular account.
SAVING - A savings account.
CREDITCARD - A credit card account.
DEPOT - A depot for broking or similar.

transfer_type Enum, optional

Indicates if the account can be used for a transaction or not.

NONE - It is not possible to use the account for transfers.
DOMESTIC - The account can only be used for domestic transfers.
FULL - The account is fully usable.
REFERENCE - The account can only be used for transfers to one specific account.
RESTRICTED - The account might be under protection from execution or something similar. Transfers are possible, but with restricted functionality (e.g. limited transfer amount).

refreshed_at DateTime (String: "YYYY-MM-DDThh:mm:ss.sssZ), always present

The refreshed_at shows when the data for this account were last refreshed.

accounts_group_id String, optional

Accounts that are connected to other accounts are grouped by having the same id. Bank accounts with the same accounts_group_id are received from the same bank-account.

oldest_transaction_date Date (String: "YYYY-MM-DD"), optional

If transactions exist for this account, returns the date for the oldest available transaction.

consent_expected_expiry_date Date (String: "YYYY-MM-DD"), optional

The expected expiry date of a stored consent. Present if there is a stored consent for the account in question.

Will be in the format of YYYY-MM-DD according to ISO 8601.

bank_country String, optional

Country of the bank that was used during the refresh of this account. Further information can be found here.

bank_krn String, optional

The bank_krn property holds the bank krn, which is an identifier of the bank that was used during the refresh of this account. Further information can be found here.

integration_krn String, optional

The integration_krn property holds the krn of the used integration that was used during the refresh of this account. Further information can be found here and here.

sub_integration_krn String, optional

The sub_integration_krn property holds the krn of the subintegration that was used during the refresh of this account. Further information can be found here and here.

labels Object, optional

Any amount of labels consisting of key-value pairs.

Example request

{
    "insights_consumer_id": "6c03aff-8fa0046-ffae74-b0cbc-4d5fd1"
}

Example response

{
    "data": {
        "reports": [
            {
                "type": "ACCOUNT_INFOS",
                "insights_consumer_id": "6c03aff-8fa0046-ffae74-b0cbc-4d5fd1",
                "insights_account_ids": [
                    "3b3d678f-66b7-4b23-a2a5-0bfd275e86a1"
                ],
                "account_alias": "Girokonto(KarlMustermann)",
                "holder_name": "Karl Mustermann",
                "bank_name": "N26",
                "currency": "EUR",
                "country": "DE",
                "iban": "DE06000000000023456789",
                "bic": "SFRTDE20XXX",
                "account_type": "DEFAULT",
                "transfer_type": "FULL",
                "refreshed_at": "2021-06-15T09:22:02.523Z",
                "oldest_transaction_date": "2021-02-15",
                "consent_expected_expiry_date": "2021-07-26",
                "labels": {
                    "market": "de"
                }
            }
        ]
    }
}

Account Info