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": "BG5Bad 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."
}
}
}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":Bad Request
Unauthorized
Forbidden
Internal Server Error
/consents
/consents/{consent-id}
/consents/{consent-id}/status
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"
}
}
}