After successfull authorisation of account access consent an AISP may retreive account inormation using GET endpoints.
The call to GET /accounts is the first step after an account-access-consent is authorised. This will allow the AISP to discover which accounts (and AccountId values) are associated with the authorisation of consent.
Required permissions:
Related security requirements: request must contain consent access token.
Request:
GET https://pg:8745/api/accounts
Authorization:Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUxMiJ9.eyJzdWIiOiJUUFAxIiwiY29uc2VudElkIjoidm9uNHdlbDFTVm1GOGJxVkJWekNaQSIsImlzcyI6IkFQSV9HVyIsImV4cCI6MTU2MzI5NjUzMSwiaWF0IjoxNTYzMjEwMTMxfQ.JjoZgEsnBQDMhj7V1Gr81eEJFzS0c4t37mqiaCgwmXBCu3RPVH-tsdVXi-3Ghen2gMM0VzDXcbwlydvW43XB1nDHkRPO1css2kPhayKH50W7ZmK2f9hgAzdSUkOEw8Fjip9qnqK-WMZSQXKYcaIKZi3QTZK6PITl0Ozo4uFW0EL35eNtp7IKMr3rS3PDNggdhzD_h2Un6k_n-eXX1vn_GK8xq6F0OCllN4g6n0oMmcVWo-0k07EpxxsfFn6WF0qjt-OhEXE-EEivzJbyW51YtX5t96PLvxyS-ZEKhjf6jrKuBaRvffGI6aTuy45AxufSIOgU6Z6ni_Wq4hLvvgJdaQ
Accept:application/json
UserAgent:B-6t99-yRUGaNOy3otR1cA
x-fapi-auth-date: Wed, 10 Jul 2019 19:43:31 GMT
x-fapi-customer-ip-address: 104.25.212.99
x-fapi-interaction-id: 93bac548-d2de-4546-b106-880a5018460d
Response:
HTTP/1.1 200 OK
x-fapi-interaction-id: 93bac548-d2de-4546-b106-880a5018460d
Content-Type: application/json
{
"Data": {
"Account": [
{
"AccountId": "HtmXXkRsQvWaXE1gKFuAQA",
"Status": "Enabled",
"Currency": "BEF",
"AccountType": "Personal",
"AccountSubType": "CreditCard",
"Nickname": "MOHAMED ELBAYOUMI",
"Account": [
{
"SchemeName": "PAN",
"Identification": "430632XXXXXX5718"
}
],
"Servicer": {
"SchemeName": "BICFI",
"Identification": "BBKUBHB0"
}
},
{
"AccountId": "DcABDNVxTyS5mjTbh5TSnQ",
"Status": "Disabled",
"Currency": "BHD",
"AccountType": "Personal",
"AccountSubType": "Savings",
"Nickname": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"Account": [
{
"SchemeName": "IBAN",
"Identification": "BH10BBKU00100000003385"
},
{
"SchemeName": "BBAN",
"Identification": "100000003385"
}
],
"Servicer": {
"SchemeName": "BICFI",
"Identification": "BBKUBHB0"
}
},
{
"AccountId": "nRQ2hx4zRHmeSkeq591lFA",
"Status": "Enabled",
"Currency": "BHD",
"AccountType": "Personal",
"AccountSubType": "CurrentAccount",
"Nickname": "YOUSIF ABDULLA AMEEN",
"Account": [
{
"SchemeName": "IBAN",
"Identification": "BH22BBKU00100000006564"
},
{
"SchemeName": "BBAN",
"Identification": "100000006564"
}
],
"Servicer": {
"SchemeName": "BICFI",
"Identification": "BBKUBHB0"
}
},
{
"AccountId": "omfDJFGYQmC2gFk9jDCxBg",
"Status": "Enabled",
"Currency": "BHD",
"AccountType": "Personal",
"AccountSubType": "CurrentAccount",
"Nickname": "AHMED ISSA MANSOOR",
"Account": [
{
"SchemeName": "IBAN",
"Identification": "BH81BBKU00100000005211"
},
{
"SchemeName": "BBAN",
"Identification": "100000005211"
}
],
"Servicer": {
"SchemeName": "BICFI",
"Identification": "BBKUBHB0"
}
}
]
},
"Links": null
}
An AISP may also retrieve the account resource details specifically for AccountId using GET /accounts/{AccountId}.
Required permissions:
Related security requirements: request must contain consent access token.
Request:
GET https://pg:8745/api/accounts/HtmXXkRsQvWaXE1gKFuAQA
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUxMiJ9.eyJzdWIiOiJUUFAxIiwic2NvcGUiOiJhY2NvdW50cyIsImlzcyI6IkFQSV9HVyIsImV4cCI6MTU2MjEwMjk2NiwiaWF0IjoxNTYyMDE2NTY2fQ.O0kofzzl5vevkD_PcVsv9-cy-2Gx5NZES7EW_AXR2vqng50o8z65_yn04lB641FfI7EnmKnYviEc4-Yq5MYLwaPPNyD7lG7rOkzo7ZD3eCpOjPgbkeegdPkpKrOktTyoKQJSX4rY0uhUTTGct2leoCdI6lKpjU_zYwFSp9-Te4f_TKQ69pOwMIFJeqi_OjIVjwGmlVLhuSTHPps4hhjCGJCySQCbeZcDcbb1WmISBXIDq2hZnaF2OXnfO4FZooVuh1yg6bbc0bA5Y-_hdTP0kEBRhnrb7m0gBXn9n3G4HKU6X6UnsgN7oK_Hq4MlFAjroFOZzCfChv6m3gCAnDxGLA
x-fapi-auth-date: Wed, 10 Jul 2019 19:43:31 GMT
x-fapi-customer-ip-address: 104.25.212.99
x-fapi-interaction-id: 93bac548-d2de-4546-b106-880a5018460d
Accept: application/json
Response:
HTTP/1.1 200 OK
x-fapi-interaction-id: 93bac548-d2de-4546-b106-880a5018460d
Content-Type: application/json
{
"Data": {
"Account": [
{
"AccountId": "HtmXXkRsQvWaXE1gKFuAQA",
"Status": "Enabled",
"Currency": "BEF",
"AccountType": "Personal",
"AccountSubType": "CreditCard",
"Nickname": "MOHAMED ELBAYOUMI",
"Account": [
{
"SchemeName": "PAN",
"Identification": "430632XXXXXX5718"
}
],
"Servicer": {
"SchemeName": "BICFI",
"Identification": "BBKUBHB0"
}
}
]
},
"Links": null
}