AccountInfo
The AccountInfo endpoint is used to request an overview of submitted accounts for ConsentCollectionId's.
Calling AccountInfo
Endpoint: https://openbanking.invers.nl/api/v1/accounts/info
Method: GET
Header: ApiKey: string (required)
X-Request-ID: string (required)
Get-Parameters: ConsentCollectionId: string (required)
Body: empty
Errors: 400, 403 or 500
Parameters
Parameter | Description |
---|---|
ApiKey | ApiKey Example: cEZrSmVPLTN1XzVDM09nVDhEanlZaUJwYzRXTldpVUc= |
X-Request-ID | Request identifier, guid that is unique for each request. Example: f1b8d9bd-0118-47ff-bdb7-5e2956ad0e9f |
ConsentCollectionId | Consent Collection Identifier from which information is being requested. Example: d2c95f1b-6802-459e-ba7d-70491ac27d24 |
Output
Field | Type | Description |
---|---|---|
bankId | guid | Bank identifier |
bankName | string | Name of the bank |
consentedOn | datetime | Date of consent |
expiresOn | datetime | Date untill the consent is valid |
fromHistoryDate | datetime | Oldest date for which transactions are available; if downloading of history is allowed |
status | string | Consent status, see Consent status |
IBan | string | |
lastdownload | datetime | Last download datedownload |
historyAvailable | bool | True if historical transactions may be downloaded |
name | string | Bank account owner's name |
product | string | Bank account type if available |
ConsentStatus
Value | Name | Description |
---|---|---|
0 | Received | Consent has been received |
1 | Rejected | Consent has been rejected |
2 | Valid | Consent is valid |
3 | RevokedByPsu | Consent has been revoked by user |
4 | Expired | Consent has expired |
5 | TerminatedByTpp | Consent has been terminated by the provider |
The most frequent values are valid and expired; Others are much less common.
Example output
[
{
"BankId": "ec3e0888-36ac-4a96-aaf7-4aa744f0d5d7",
"BankName": "ING bank",
"ConsentedOn": "2020-08-28T09:45:56",
"ExpiresOn": "2019-06-30T00:00:00+02:00",
"FromHistoryDate": "2019-06-30T00:00:00+02:00",
"Status": "Expired",
"IBan": "NL69INGB0123456789",
"Lastdownload": "2020-08-28T00:00:00+02:00",
"HistoryAvailable": false,
"Name": "Bob Tuinman",
"Product": null
},
{
"BankId": "ec3e0888-36ac-4a96-aaf7-4aa744f0d5d7",
"BankName": "ING bank",
"ConsentedOn": "2020-08-28T09:45:56",
"ExpiresOn": "2019-06-30T00:00:00+02:00",
"FromHistoryDate": "2019-06-30T00:00:00+02:00",
"Status": "Expired",
"IBan": "NL69INGB0123456789",
"Lastdownload": "2020-08-28T00:00:00+02:00",
"HistoryAvailable": false,
"Name": "Bob Tuinman",
"Product": null
}
]