After successfull authorisation of account access consent an AISP may retreive account balance using GET endpoints.
If an ASPSP has implemented the bulk retrieval endpoints, an AISP may optionally retrieve the account information resources in bulk using .
Required permissions: ReadBalances.
Related security requirements: request must contain consent access token.
Request:
GET https://pg:8745/api/balances
Authorization:Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUxMiJ9.eyJzdWIiOiJUUFAxIiwiY29uc2VudElkIjoidm9uNHdlbDFTVm1GOGJxVkJWekNaQSIsImlzcyI6IkFQSV9HVyIsImV4cCI6MTU2MzI5NjUzMSwiaWF0IjoxNTYzMjEwMTMxfQ.JjoZgEsnBQDMhj7V1Gr81eEJFzS0c4t37mqiaCgwmXBCu3RPVH-tsdVXi-3Ghen2gMM0VzDXcbwlydvW43XB1nDHkRPO1css2kPhayKH50W7ZmK2f9hgAzdSUkOEw8Fjip9qnqK-WMZSQXKYcaIKZi3QTZK6PITl0Ozo4uFW0EL35eNtp7IKMr3rS3PDNggdhzD_h2Un6k_n-eXX1vn_GK8xq6F0OCllN4g6n0oMmcVWo-0k07EpxxsfFn6WF0qjt-OhEXE-EEivzJbyW51YtX5t96PLvxyS-ZEKhjf6jrKuBaRvffGI6aTuy45AxufSIOgU6Z6ni_Wq4hLvvgJdaQ
Accept:application/json
Response:
HTTP/1.1 200 OK
x-fapi-interaction-id: 93bac548-d2de-4546-b106-880a5018460d
Content-Type: application/json
{
"Data": {
"Balance": [
{
"AccountId": "HtmXXkRsQvWaXE1gKFuAQA",
"Amount": {
"Amount": "126.624",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Available",
"DateTime": "2019-07-16T10:48:42.731+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "200.000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
},
{
"AccountId": "DcABDNVxTyS5mjTbh5TSnQ",
"Amount": {
"Amount": "9119348.264000",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Available",
"DateTime": "2019-07-16T10:48:42.873+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "150000.000000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
},
{
"AccountId": "DcABDNVxTyS5mjTbh5TSnQ",
"Amount": {
"Amount": "9119349.264000",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Book",
"DateTime": "2019-07-16T10:48:42.873+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "150000.000000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
},
{
"AccountId": "nRQ2hx4zRHmeSkeq591lFA",
"Amount": {
"Amount": "9119348.264000",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Available",
"DateTime": "2019-07-16T10:48:42.935+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "150000.000000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
},
{
"AccountId": "nRQ2hx4zRHmeSkeq591lFA",
"Amount": {
"Amount": "9119349.264000",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Book",
"DateTime": "2019-07-16T10:48:42.935+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "150000.000000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
},
{
"AccountId": "omfDJFGYQmC2gFk9jDCxBg",
"Amount": {
"Amount": "9119348.264000",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Available",
"DateTime": "2019-07-16T10:48:42.977+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "150000.000000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
},
{
"AccountId": "omfDJFGYQmC2gFk9jDCxBg",
"Amount": {
"Amount": "9119349.264000",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Book",
"DateTime": "2019-07-16T10:48:42.977+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "150000.000000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
}
]
},
"Links": null
}
An AISP may retrieve the account balance information resource for a specific AccountId (which is retrieved in the call to GET /accounts).
Required permissions: ReadBalances.
Related security requirements: request must contain consent access token.
Request:
Authorization:Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUxMiJ9.eyJzdWIiOiJUUFAxIiwiY29uc2VudElkIjoidm9uNHdlbDFTVm1GOGJxVkJWekNaQSIsImlzcyI6IkFQSV9HVyIsImV4cCI6MTU2MzI5NjUzMSwiaWF0IjoxNTYzMjEwMTMxfQ.JjoZgEsnBQDMhj7V1Gr81eEJFzS0c4t37mqiaCgwmXBCu3RPVH-tsdVXi-3Ghen2gMM0VzDXcbwlydvW43XB1nDHkRPO1css2kPhayKH50W7ZmK2f9hgAzdSUkOEw8Fjip9qnqK-WMZSQXKYcaIKZi3QTZK6PITl0Ozo4uFW0EL35eNtp7IKMr3rS3PDNggdhzD_h2Un6k_n-eXX1vn_GK8xq6F0OCllN4g6n0oMmcVWo-0k07EpxxsfFn6WF0qjt-OhEXE-EEivzJbyW51YtX5t96PLvxyS-ZEKhjf6jrKuBaRvffGI6aTuy45AxufSIOgU6Z6ni_Wq4hLvvgJdaQ
Accept:application/json
Response:
HTTP/1.1 200 OK
x-fapi-interaction-id: 93bac548-d2de-4546-b106-880a5018460d
Content-Type: application/json
{
"Data": {
"Balance": [
{
"AccountId": "HtmXXkRsQvWaXE1gKFuAQA",
"Amount": {
"Amount": "126.624",
"Currency": "BHD"
},
"CreditDebitIndicator": "Credit",
"Type": "Available",
"DateTime": "2019-07-16T10:55:14.513+03:00[Europe/Moscow]",
"CreditLine": [
{
"Included": true,
"Amount": {
"Amount": "200.000",
"Currency": "BHD"
},
"Type": "Credit"
}
]
}
]
},
"Links": null
}