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
}
]