Account Information Service Provider API
Paths
/accounts
Read account list
Read the list of all accessible accounts relative to a granted consent. It is assumed that a consent of the PSU to this access is already given and stored on the BDSK system. The addressed list of accounts depends then on the PSU ID and OAuth2 access token. Returns all identifiers of the accounts, to which an account access has been granted to through the /consents endpoint by the PSU. In addition, relevant information about the accounts and hyperlinks to corresponding account information resources are provided if a related consent has been already granted.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
With balance flag.
OK
{
"schema": {
"type": "object",
"properties": {
"accounts": {
"type": "array",
"items": {
"$ref": "#\/definitions\/Account"
}
}
},
"example": {
"accounts": [
{
"resourceId": "BG10STSA11223344556677",
"iban": "BG10STSA11223344556677",
"currency": "BGN",
"product": "РС ЛИДЕР С РО 0406",
"name": "salary",
"_links": {
"balances": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/balances"
},
"transactions": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/transactions"
}
}
},
{
"resourceId": "BG5
{
"schema": {
"type": "object",
"properties": {
"accounts": {
"type": "array",
"items": {
"$ref": "#\/definitions\/Account"
}
}
},
"example": {
"accounts": [
{
"resourceId": "BG10STSA11223344556677",
"iban": "BG10STSA11223344556677",
"currency": "BGN",
"product": "РС ЛИДЕР С РО 0406",
"name": "salary",
"_links": {
"balances": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/balances"
},
"transactions": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/transactions"
}
}
},
{
"resourceId": "BG52STSA99887766554433",
"iban": "BG52STSA99887766554433",
"currency": "EUR",
"product": "Ч-НО Б-НЕ ”123”",
"name": "за спестяване“",
"_links": {
"balances": {
"href": "\/v1\/accounts\/BG52STSA99887766554433\/balances"
}
}
}
]
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
x
Bad Request
Unauthorized
Forbidden
Internal Server Error
/accounts/{account-id}
Read Account Details
Reads details about the addressed account. It is assumed that a consent of the PSU to this access is already given and stored on the BDSK system. The addressed details of this account depends then on the stored consent addressed by the OAuth2 access token.
The account-id is retrieved by using a "Read Account List" call. The account-id is the "resourceId" attribute of the account structure. Its value is constant at least throughout the lifecycle of a given consent.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
With balance flag.
OK
{
"schema": {
"type": "object",
"properties": {
"account": {
"$ref": "#\/definitions\/Account"
}
},
"example": {
"account": {
"resourceId": "BG10STSA11223344556677",
"iban": "BG10STSA11223344556677",
"currency": "BGN",
"product": "РС ЛИДЕР С РО 0406",
"name": "salary",
"_links": {
"balances": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/balances"
},
"transactions": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/transactions"
}
}
}
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
{
"schema": {
"type": "object",
"properties": {
"account": {
"$ref": "#\/definitions\/Account"
}
},
"example": {
"account": {
"resourceId": "BG10STSA11223344556677",
"iban": "BG10STSA11223344556677",
"currency": "BGN",
"product": "РС ЛИДЕР С РО 0406",
"name": "salary",
"_links": {
"balances": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/balances"
},
"transactions": {
"href": "\/v1\/accounts\/BG10STSA11223344556677\/transactions"
}
}
}
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
x
Bad Request
Unauthorized
Forbidden
Internal Server Error
/accounts/{account-id}/balances
Read Balance
Reads the balance list for a given account addressed by "account-id".
The account-id is retrieved by using a "Read Account List" call. The account-id is the "resourceId" attribute of the account structure. Its value is constant at least throughout the lifecycle of a given consent.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
OK
{
"schema": {
"type": "object",
"properties": {
"account": {
"$ref": "#\/definitions\/AccountReference"
},
"balances": {
"type": "array",
"items": {
"$ref": "#\/definitions\/SingleBalance"
}
}
},
"example": {
"account": {
"iban": "BG10STSA11223344556677"
},
"balances": [
{
"balanceType": "interimAvailable",
"balanceAmount": {
"currency": "BGN",
"amount": 123.45
}
}
]
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
Bad Request
Unauthorized
Forbidden
Internal Server Error
/accounts/{account-id}/transactions
Read Transaction List
Read transaction lists of a given account аddressed by "account-id", depending on the steering parameter "bookingStatus" and the attributes "dateFrom" and "dateTo".
The account-id is retrieved by using a "Read Account List" call. The account-id is the "resourceId" attribute of the account structure. Its value is constant at least throughout the lifecycle of a given consent.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
Starting date (inclusive the date dateFrom) of the transaction list.
{
"pattern": "([12]\\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))"
}
End date (inclusive the data dateTo) of the transaction list, default is now if not given.
{
"pattern": "([12]\\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))"
}
Permitted codes are “booked”, “pending” and “both”
{
"pattern": "(booked|pending|both)"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
OK
{
"schema": {
"type": "object",
"properties": {
"account": {
"$ref": "#\/definitions\/AccountReference"
},
"transactions": {
"$ref": "#\/definitions\/AccountReport"
},
"_links": {
"$ref": "#\/definitions\/Links"
}
},
"example": {
"account": {
"iban": "BG10STSA11223344556677"
},
"transactions": {
"booked": [
{
"creditorName": "Иван Иванов",
"creditorAccount": {
"iban": "BG10STSA12345671234567"
},
"transactionAmount": {
"currency": "BGN",
"amount": "200.00"
},
"bookingDate": "2018-07-02",
"valueDate":
{
"schema": {
"type": "object",
"properties": {
"account": {
"$ref": "#\/definitions\/AccountReference"
},
"transactions": {
"$ref": "#\/definitions\/AccountReport"
},
"_links": {
"$ref": "#\/definitions\/Links"
}
},
"example": {
"account": {
"iban": "BG10STSA11223344556677"
},
"transactions": {
"booked": [
{
"creditorName": "Иван Иванов",
"creditorAccount": {
"iban": "BG10STSA12345671234567"
},
"transactionAmount": {
"currency": "BGN",
"amount": "200.00"
},
"bookingDate": "2018-07-02",
"valueDate": "2018-07-03",
"remittanceInformationUnstructured": "Захранване на сметка"
},
{
"debtorName": "Фирма ЕООД",
"debtorAccount": {
"iban": "BG10STSA76543211234567"
},
"transactionAmount": {
"currency": "BGN",
"amount": "49.51"
},
"bookingDate": "2018-07-04",
"valueDate": "2018-07-05",
"remittanceInformationUnstructured": "Такса курс"
}
],
"pending": [
{
"creditorName": "Booking Co",
"creditorAccount": {
"iban": "FR12345677654321"
},
"transactionAmount": {
"currency": "BGN",
"amount": "1080.04"
},
"valueDate": "2017-10-26",
"remittanceInformationUnstructured": "hotel"
}
],
"_links": {
"account": {
"href": "\/v1\/accounts\/BG10STSA11223344556677"
}
}
}
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
x
Bad Request
Unauthorized
Forbidden
Internal Server Error
/consents
Get Consent
Return valid Consent Id for PSU-TPP consent.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
OK
{
"schema": {
"type": "object",
"properties": {
"consents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"consentId": {
"type": "string"
}
}
}
}
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
Bad Request
Internal Server Error
Create consent
This method create a consent resource, defining access rights to dedicated accounts of a given PSU. Only access rights are inserted without mentioning the addressed account. The relation to accounts is then handled afterwards between PSU and BDSK.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
URI of the TPP, where the transaction flow shall be redirected to after a Redirect
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
Created
{
"schema": {
"type": "object",
"properties": {
"consentStatus": {
"$ref": "#\/definitions\/ConsentStatus"
},
"consentId": {
"type": "string"
},
"_links": {
"$ref": "#\/definitions\/Links"
}
},
"example": {
"consentStatus": "received",
"consentId": "12345687878",
"_links": {
"scaRedirect": {
"href": "https:\/\/dsk\/authentication\/12345687878"
},
"self": {
"href": "\/v1\/consents\/12345687878"
},
"status": {
"href": "\/v1\/consents\/12345687878\/status"
}
}
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the
{
"schema": {
"type": "object",
"properties": {
"consentStatus": {
"$ref": "#\/definitions\/ConsentStatus"
},
"consentId": {
"type": "string"
},
"_links": {
"$ref": "#\/definitions\/Links"
}
},
"example": {
"consentStatus": "received",
"consentId": "12345687878",
"_links": {
"scaRedirect": {
"href": "https:\/\/dsk\/authentication\/12345687878"
},
"self": {
"href": "\/v1\/consents\/12345687878"
},
"status": {
"href": "\/v1\/consents\/12345687878\/status"
}
}
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
},
"Location": {
"type": "string",
"description": "hyperlink for the status of the resource."
},
"ASPSP-SCA-Approach": {
"type": "string",
"description": "Possible value is REDIRECT."
}
}
}
x
Bad Request
Internal Server Error
/consents/{consent-id}
Get Consent Request
Reads the exact definition of the given consent resource {consent-id}
ID of the corresponding consent object as returned by an Account Information Consent Request
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
Delete consent
The TPP can delete an account information consent object if needed.
ID of the corresponding consent object as returned by an Account Information Consent Request
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
/consents/{consent-id}/status
Consent status request
Reads the transaction status of the addressed consent resource.
ID of the corresponding consent object as returned by an Account Information Consent Request
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
OK
{
"schema": {
"type": "object",
"required": [
"consentStatus"
],
"properties": {
"consentStatus": {
"$ref": "#\/definitions\/ConsentStatus"
},
"scaStatus": {
"type": "string",
"enum": [
"finalised"
]
}
},
"example": {
"consentStatus": "terminatedByTpp",
"scaStatus": "finalised"
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
Bad Request
Internal Server Error
Definitions
{
"type": "object",
"required": [
"currency",
"amount"
],
"properties": {
"currency": {
"type": "string",
"description": "ISO 4217 code"
},
"amount": {
"type": "string",
"pattern": "^[0-9]\\d{0,13}(\\.\\d{1,2})?$"
}
}
}
{
"type": "object",
"required": [
"currency",
"resourceId",
"iban",
"name",
"product"
],
"properties": {
"resourceId": {
"type": "string",
"description": "This is the data element to be used in the path when retrieving data from a dedicated account."
},
"iban": {
"type": "string",
"description": "IBAN of account"
},
"name": {
"type": "string",
"description": "Name given by the bank or the PSU in OnlineBanking."
},
"product": {
"type": "string",
"description": "Product Name of the Bank for this account"
},
"currency": {
"type": "string",
"description": "ISO 4217 code"
},
"_links": {
"$ref": "#\/definitions\/Links",
"description": "Links to the account, which can be directly used for retrieving account information from this dedicated account. Links to “balances” and\/or “transactions”"
}
}
}
{
"type": "object",
"required": [
"booked"
],
"properties": {
"booked": {
"type": "array",
"items": {
"$ref": "#\/definitions\/Transactions"
}
},
"pending": {
"type": "array",
"items": {
"$ref": "#\/definitions\/Transactions"
}
}
}
}
{
"type": "object",
"properties": {
"interimAvailable": {
"$ref": "#\/definitions\/SingleBalance",
"description": "Available balance calculated in the course of the account ’ervicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time\/period specified."
}
}
}
{
"type": "object",
"required": [
"balanceAmount"
],
"properties": {
"balanceType": {
"type": "string"
},
"balanceAmount": {
"$ref": "#\/definitions\/Amount"
}
}
}
{
"type": "object",
"required": [
"transactionAmount"
],
"properties": {
"transactionId": {
"type": "string",
"description": "Can be used as access-id in the API, where more details on an transaction is offered."
},
"bookingDate": {
"type": "string",
"format": "date"
},
"valueDate": {
"type": "string",
"format": "date"
},
"transactionAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorName": {
"type": "string",
"description": "Name of the creditor if a “Debited” transaction"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"debtorName": {
"type": "string",
"description": "Name of the debtor if a “Credited” transaction"
},
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"remittanceInformationUnstructured": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"scaRedirect": {
"$ref": "#\/definitions\/Href",
"description": "A link to a BDSK site where SCA is performed within the Redirect SCA approach."
},
"self": {
"$ref": "#\/definitions\/Href",
"description": "The link to the resource created by the undergoing request. This link can be used to retrieve the resource data."
},
"status": {
"$ref": "#\/definitions\/Href"
},
"account": {
"$ref": "#\/definitions\/Href",
"description": "A link to an account, which can be directly used for retrieving account information from this dedicated account."
},
"balances": {
"$ref": "#\/definitions\/Href",
"description": "A link to the resource providing the balance of a dedicated account."
},
"transactions": {
"$ref": "#\/definitions\/Href",
"description": "A link to the resource providing the transaction history of a dedicated account."
},
"first": {
"$ref": "#\/definitions\/Href",
"description": "Navigation link for account reports."
},
"next": {
"$ref": "#\/definitions\/Href",
"description": "Navigation link for account reports."
},
"previous": {
"$ref": "#\/definitions\/Href",
"description": "Navigation link for account reports."
},
"last": {
"$ref": "#\/definitions\/Href",
"description": "Navigation link for account reports."
}
}
}
{
"type": "object",
"properties": {
"tppMessages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"category": {
"type": "string"
},
"code": {
"type": "string"
},
"text": {
"type": "string"
}
}
}
}
}
}
{
"type": "object",
"required": [
"access",
"frequencyPerDay",
"recurringIndicator",
"validUntil"
],
"properties": {
"access": {
"type": "object",
"properties": {
"balances": {
"type": "array",
"items": {
"type": "string",
"default": ""
}
},
"transactions": {
"type": "array",
"items": {
"type": "string",
"default": ""
}
}
}
},
"recurringIndicator": {
"type": "string",
"format": "boolean",
"description": "TRUE, if the consent is for recurring access to the account data. FALSE, if the consent is for one access to the account data.",
"pattern": "(true|false)",
"default": "true"
},
"validUntil": {
"type": "string",
"format": "date",
"description": "This parameter is requesting a valid until date for the requested consent. Max validity is 90 day. If the consent is for one access to the account data value is current date.The content is the local BDSK date in ISODate Format, e.g. 2018-11-25",
"pattern": "([12]\\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))",
"default": "2019-01-18"
},
"frequencyPerDay": {
"type": "string",
"format": "integer",
"description": "This field indicates the requested maximum frequency for an access per day. For a one-off access, this attribute is set to “1”. Max value is “4”.",
"pattern": "[1-4]",
"default": "4"
}
}
}
{
"required": [
"access",
"recurringIndicator",
"validUntil",
"frequencyPerDay",
"consentStatus",
"_links"
],
"type": "object",
"properties": {
"access": {
"$ref": "#\/definitions\/AccountAccess"
},
"recurringIndicator": {
"type": "boolean",
"description": "TRUE, if the consent is for recurring access to the account data FALSE, if the consent is for one access to the account data"
},
"validUntil": {
"type": "string",
"format": "date",
"description": "This parameter is requesting a valid until date for the requested consent. The content is the local BDSK date in ISODate Format, e.g. 2017-10-30"
},
"frequencyPerDay": {
"type": "integer",
"description": "Max value is \"4\"."
},
"consentStatus": {
"$ref": "#\/definitions\/ConsentStatus"
},
"_links": {
"$ref": "#\/definitions\/Links"
}
},
"example": {
"access": {
"balances": [
{
"iban": "BG10STSA11223344556677"
}
],
"transactions": [
{
"iban": "BG52STSA99887766554433"
},
{
"iban": "BG10STSA76543211234567"
}
]
},
"recurringIndicator": true,
"validUntil": "2018-12-25",
"frequencyPerDay": 2,
"consentStatus": "valid",
"_links": {
"account": {
"href": "\/v1\/accounts\/"
}
}
}
}
{
"properties": {
"iban": {
"type": "string"
},
"bban": {
"type": "string"
}
},
"additionalProperties": false
}
The following code values are permitted “received”, “rejected”, “valid”, “revokedByPsu”, “expired”, “terminatedByTpp”
{
"type": "string",
"enum": [
"received",
"rejected",
"valid",
"revokedByPsu",
"expired",
"terminatedByTpp"
]
}
{
"properties": {
"balances": {
"type": "array",
"items": {
"$ref": "#\/definitions\/AccountReference"
}
},
"transactions": {
"type": "array",
"items": {
"$ref": "#\/definitions\/AccountReference"
}
}
},
"additionalProperties": false
}
{
"type": "string",
"properties": {
"href": {
"type": "string"
}
}
}