Create
The API allows the TPP to ask an PASP to create a new account-access-consent resource.
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.eyJEYXRhIjp7IlBlcm1pc3Npb25zIjpbIlJlYWRBY2NvdW50c0Jhc2ljIiwiUmVhZEFjY291bnRzRGV0YWlsIiwiUmVhZEJhbGFuY2VzIiwiUmVhZEJlbmVmaWNpYXJpZXNEZXRhaWwiLCJSZWFkVHJhbnNhY3Rpb25zQmFzaWMiLCJSZWFkVHJhbnNhY3Rpb25zQ3JlZGl0cyIsIlJlYWRUcmFuc2FjdGlvbnNEZWJpdHMiLCJSZWFkVHJhbnNhY3Rpb25zRGV0YWlsIiwiUmVhZE9mZmVycyIsIlJlYWRQQU4iLCJSZWFkUGFydHkiLCJSZWFkUGFydHlQU1UiLCJSZWFkUHJvZHVjdHMiLCJSZWFkU3RhbmRpbmdPcmRlcnNEZXRhaWwiLCJSZWFkU2NoZWR1bGVkUGF5bWVudHNEZXRhaWwiLCJSZWFkU3RhdGVtZW50c0RldGFpbCIsIlJlYWREaXJlY3REZWJpdHMiXSwiRXhwaXJhdGlvbkRhdGVUaW1lIjoiMjAxNy0wNS0wMlQwMDowMDowMCswMDowMCIsIlRyYW5zYWN0aW9uRnJvbURhdGVUaW1lIjoiMjAxNy0wNS0wM1QwMDowMDowMCswMDowMCIsIlRyYW5zYWN0aW9uVG9EYXRlVGltZSI6IjIwMTctMTItMDNUMDA6MDA6MDArMDA6MDAifSwiUmlzayI6e319.Ljj_DKgtxbsyoJ7XbVqx_pReizJhRRAf_GoiOKTHxSJYdmjpmZm6r-T-k_ypZT3KkWYhFCxCJevC0kQ-crFJgjLWmC_5y0DPyr8wfaHIKHeJNM4UAJVbeqLEuOcqQSJZFYm3MBE25Xrfkos_G7JFqhdL-j8f3Zzl2bUvh_2Fu7lgu2Eq8EriPD4j1Il9I_fcwEasCCuBm3bSRPSVcT0nb7K4fV0fr574_7lRQOGdhV7ggbyKAA88nl4VDsd1ki4XuE2P06xJCkGlMrsygFcqBA5NBhYZ1EJfZaDoW3bcg1jMS5yKbFJYU7CKZKXynEBV-19P6hhbs9LrNqcBq_XV-g' \
-X POST "/api/:provider_code/open-banking/v3.1/aisp/account-access-consents"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.eyJEYXRhIjp7IlBlcm1pc3Npb25zIjpbIlJlYWRBY2NvdW50c0Jhc2ljIiwiUmVhZEFjY291bnRzRGV0YWlsIiwiUmVhZEJhbGFuY2VzIiwiUmVhZEJlbmVmaWNpYXJpZXNEZXRhaWwiLCJSZWFkVHJhbnNhY3Rpb25zQmFzaWMiLCJSZWFkVHJhbnNhY3Rpb25zQ3JlZGl0cyIsIlJlYWRUcmFuc2FjdGlvbnNEZWJpdHMiLCJSZWFkVHJhbnNhY3Rpb25zRGV0YWlsIiwiUmVhZE9mZmVycyIsIlJlYWRQQU4iLCJSZWFkUGFydHkiLCJSZWFkUGFydHlQU1UiLCJSZWFkUHJvZHVjdHMiLCJSZWFkU3RhbmRpbmdPcmRlcnNEZXRhaWwiLCJSZWFkU2NoZWR1bGVkUGF5bWVudHNEZXRhaWwiLCJSZWFkU3RhdGVtZW50c0RldGFpbCIsIlJlYWREaXJlY3REZWJpdHMiXSwiRXhwaXJhdGlvbkRhdGVUaW1lIjoiMjAxNy0wNS0wMlQwMDowMDowMCswMDowMCIsIlRyYW5zYWN0aW9uRnJvbURhdGVUaW1lIjoiMjAxNy0wNS0wM1QwMDowMDowMCswMDowMCIsIlRyYW5zYWN0aW9uVG9EYXRlVGltZSI6IjIwMTctMTItMDNUMDA6MDA6MDArMDA6MDAifSwiUmlzayI6e319.Ljj_DKgtxbsyoJ7XbVqx_pReizJhRRAf_GoiOKTHxSJYdmjpmZm6r-T-k_ypZT3KkWYhFCxCJevC0kQ-crFJgjLWmC_5y0DPyr8wfaHIKHeJNM4UAJVbeqLEuOcqQSJZFYm3MBE25Xrfkos_G7JFqhdL-j8f3Zzl2bUvh_2Fu7lgu2Eq8EriPD4j1Il9I_fcwEasCCuBm3bSRPSVcT0nb7K4fV0fr574_7lRQOGdhV7ggbyKAA88nl4VDsd1ki4XuE2P06xJCkGlMrsygFcqBA5NBhYZ1EJfZaDoW3bcg1jMS5yKbFJYU7CKZKXynEBV-19P6hhbs9LrNqcBq_XV-g' \
-X POST "/api/:provider_code/open-banking/v3.1/aisp/account-access-consents"
Example of request
{"Data":{"Permissions":["ReadAccountsBasic","ReadAccountsDetail","ReadBalances","ReadBeneficiariesDetail","ReadTransactionsBasic","ReadTransactionsCredits","ReadTransactionsDebits","ReadTransactionsDetail","ReadOffers","ReadPAN","ReadParty","ReadPartyPSU","ReadProducts","ReadStandingOrdersDetail","ReadScheduledPaymentsDetail","ReadStatementsDetail","ReadDirectDebits"],"ExpirationDateTime":"2017-05-02T00:00:00+00:00","TransactionFromDateTime":"2017-05-03T00:00:00+00:00","TransactionToDateTime":"2017-12-03T00:00:00+00:00"},"Risk":{}}
{"Data":{"Permissions":["ReadAccountsBasic","ReadAccountsDetail","ReadBalances","ReadBeneficiariesDetail","ReadTransactionsBasic","ReadTransactionsCredits","ReadTransactionsDebits","ReadTransactionsDetail","ReadOffers","ReadPAN","ReadParty","ReadPartyPSU","ReadProducts","ReadStandingOrdersDetail","ReadScheduledPaymentsDetail","ReadStatementsDetail","ReadDirectDebits"],"ExpirationDateTime":"2017-05-02T00:00:00+00:00","TransactionFromDateTime":"2017-05-03T00:00:00+00:00","TransactionToDateTime":"2017-12-03T00:00:00+00:00"},"Risk":{}}
Example of response
{"Data":{"ConsentId":"urn-alphabank-intent-88379","Status":"AwaitingAuthorisation","StatusUpdateDateTime":"2017-05-02T00:00:00+00:00","CreationDateTime":"2017-05-02T00:00:00+00:00","Permissions":["ReadAccountsBasic","ReadAccountsDetail","ReadBalances","ReadBeneficiariesDetail","ReadTransactionsBasic","ReadTransactionsCredits","ReadTransactionsDebits","ReadTransactionsDetail","ReadOffers","ReadPAN","ReadParty","ReadPartyPSU","ReadProducts","ReadStandingOrdersDetail","ReadScheduledPaymentsDetail","ReadStatementsDetail","ReadDirectDebits"],"ExpirationDateTime":"2017-08-02T00:00:00+00:00","TransactionFromDateTime":"2017-05-03T00:00:00+00:00","TransactionToDateTime":"2017-12-03T00:00:00+00:00"},"Risk":{},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/account-access-consents/urn-alphabank-intent-88379"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"urn-alphabank-intent-88379","Status":"AwaitingAuthorisation","StatusUpdateDateTime":"2017-05-02T00:00:00+00:00","CreationDateTime":"2017-05-02T00:00:00+00:00","Permissions":["ReadAccountsBasic","ReadAccountsDetail","ReadBalances","ReadBeneficiariesDetail","ReadTransactionsBasic","ReadTransactionsCredits","ReadTransactionsDebits","ReadTransactionsDetail","ReadOffers","ReadPAN","ReadParty","ReadPartyPSU","ReadProducts","ReadStandingOrdersDetail","ReadScheduledPaymentsDetail","ReadStatementsDetail","ReadDirectDebits"],"ExpirationDateTime":"2017-08-02T00:00:00+00:00","TransactionFromDateTime":"2017-05-03T00:00:00+00:00","TransactionToDateTime":"2017-12-03T00:00:00+00:00"},"Risk":{},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/account-access-consents/urn-alphabank-intent-88379"},"Meta":{"TotalPages":1}}
Request
POST
/api/:provider_code/open-banking/v3.1/aisp/account-access-consents
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
hash, required
Wrapper for the data.
array, required
Specifies the Open Banking account access data types. This is a list of the data clusters being consented by the PSU, and requested for authorisation with the PASP.
Allowed values:
ReadAccountsBasic, ReadAccountsDetail, ReadBalances, ReadTransactionsBasic, ReadTransactionsCredits, ReadTransactionsDebits, ReadTransactionsDetail, ReadOffers, ReadPAN, ReadProducts, ReadScheduledPaymentsDetail, ReadStatementsDetail, ReadBeneficiariesDetail, ReadBeneficiariesBasic, ReadDirectDebits, ReadStandingOrdersDetail, ReadStandingOrdersBasic, ReadParty, ReadPartyPSU
Can raise:
FieldInvalid
datetime, required
Specified date and time the permissions will expire.
Values in range between:
2024-12-06T04:40:29+00:00 and 2025-03-06T04:40:29Z
Can raise:
FieldInvalidDate
datetime, optional
Specified start date and time for the transaction query period. If this is not populated, the start date will be open ended, and data will be returned from the earliest available transaction.
datetime, optional
Specified end date and time for the transaction query period. If this is not populated, the end date will be open ended, and data will be returned to the latest available transaction.
Can raise:
ResourceInvalidFormat
hash, optional
The Risk section is sent by the initiating party to the PASP. It is used to specify additional details for risk scoring for Account Info.
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
string, required
Unique identification as assigned to identify the account access consent resource.
Can raise:
FieldInvalid
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Revoked
Can raise:
FieldInvalid
datetime, required
Date and time at which the resource status was updated.
datetime, required
Date and time at which the resource was created.
array, required
Specifies the Open Banking account access data types. This is a list of the data clusters being consented by the PSU, and requested for authorisation with the PASP.
Allowed values:
ReadAccountsBasic, ReadAccountsDetail, ReadBalances, ReadTransactionsBasic, ReadTransactionsCredits, ReadTransactionsDebits, ReadTransactionsDetail, ReadOffers, ReadPAN, ReadProducts, ReadScheduledPaymentsDetail, ReadStatementsDetail, ReadBeneficiariesDetail, ReadBeneficiariesBasic, ReadDirectDebits, ReadStandingOrdersDetail, ReadStandingOrdersBasic, ReadParty, ReadPartyPSU
datetime, optional
Specified date and time the permissions will expire.
datetime, optional
Specified start date and time for the transaction query period. If this is not populated, the start date will be open ended, and data will be returned from the earliest available transaction.
datetime, optional
Specified end date and time for the transaction query period. If this is not populated, the end date will be open ended, and data will be returned to the latest available transaction.
Can raise:
ResourceInvalidFormat
hash, required
The Risk section is sent by the initiating party to the PASP. It is used to specify additional details for risk scoring for Account Info.
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
FieldInvalidDate
|
400 |
An invalid date is supplied. |
ResourceInvalidFormat
|
400 |
Payload schema does not match to the endpoint. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
Show
A TPP may optionally retrieve an account-access-consent resource that they have created to check its status. Prior to calling the API, the TPP must have an access token issued by the PASP using a client credentials grant.
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.MJXGMSAHhGjIdAlLrK6izd6DiGEKheIaVdOqXisbADdOb4_o17Ve0wX1SVRMLB1CBlFUEUsi2IXM7aVVJjt26YB_rLT03Bge7lsUaIVXDOsEJVNRm8R2S4Y0iAL_QShvxyFMZZFOJsYKgr2C-wrZ2si9innUv-n-FQAYc3SLOE1KFueRD46Ofjx2dyGG1vO3Q6l48ejckEyX1V6jif-dwWCHMDi-nVAvPZHfnafN_uo1l5_ZYAcEOkXqAFxmUzN_8Ur-mJq4z6VbYy-wUtTl8ed8S3R2wnER_maObA--MG9iyzgDytI-Hv2UXFGGqi8Ws6XTF8EsxxghQoQt4iqRaA' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/account-access-consents/:consent_id"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.MJXGMSAHhGjIdAlLrK6izd6DiGEKheIaVdOqXisbADdOb4_o17Ve0wX1SVRMLB1CBlFUEUsi2IXM7aVVJjt26YB_rLT03Bge7lsUaIVXDOsEJVNRm8R2S4Y0iAL_QShvxyFMZZFOJsYKgr2C-wrZ2si9innUv-n-FQAYc3SLOE1KFueRD46Ofjx2dyGG1vO3Q6l48ejckEyX1V6jif-dwWCHMDi-nVAvPZHfnafN_uo1l5_ZYAcEOkXqAFxmUzN_8Ur-mJq4z6VbYy-wUtTl8ed8S3R2wnER_maObA--MG9iyzgDytI-Hv2UXFGGqi8Ws6XTF8EsxxghQoQt4iqRaA' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/account-access-consents/:consent_id"
Example of response
{"Data":{"ConsentId":"urn-alphabank-intent-88379","Status":"AwaitingAuthorisation","StatusUpdateDateTime":"2017-05-02T00:00:00+00:00","CreationDateTime":"2017-05-02T00:00:00+00:00","Permissions":["ReadAccountsBasic","ReadAccountsDetail","ReadBalances","ReadBeneficiariesDetail","ReadTransactionsBasic","ReadTransactionsCredits","ReadTransactionsDebits","ReadTransactionsDetail","ReadOffers","ReadPAN","ReadParty","ReadPartyPSU","ReadProducts","ReadStandingOrdersDetail","ReadScheduledPaymentsDetail","ReadStatementsDetail","ReadDirectDebits"],"ExpirationDateTime":"2017-08-02T00:00:00+00:00","TransactionFromDateTime":"2017-05-03T00:00:00+00:00","TransactionToDateTime":"2017-12-03T00:00:00+00:00"},"Risk":{},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/account-access-consents/urn-alphabank-intent-88379"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"urn-alphabank-intent-88379","Status":"AwaitingAuthorisation","StatusUpdateDateTime":"2017-05-02T00:00:00+00:00","CreationDateTime":"2017-05-02T00:00:00+00:00","Permissions":["ReadAccountsBasic","ReadAccountsDetail","ReadBalances","ReadBeneficiariesDetail","ReadTransactionsBasic","ReadTransactionsCredits","ReadTransactionsDebits","ReadTransactionsDetail","ReadOffers","ReadPAN","ReadParty","ReadPartyPSU","ReadProducts","ReadStandingOrdersDetail","ReadScheduledPaymentsDetail","ReadStatementsDetail","ReadDirectDebits"],"ExpirationDateTime":"2017-08-02T00:00:00+00:00","TransactionFromDateTime":"2017-05-03T00:00:00+00:00","TransactionToDateTime":"2017-12-03T00:00:00+00:00"},"Risk":{},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/account-access-consents/urn-alphabank-intent-88379"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/account-access-consents/:consent_id
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
string, required
Unique identification as assigned to identify the account access consent resource.
Can raise:
FieldInvalid, ResourceNotFound
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
string, required
Unique identification as assigned to identify the account access consent resource.
Can raise:
FieldInvalid
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Revoked
Can raise:
FieldInvalid
datetime, required
Date and time at which the resource status was updated.
datetime, required
Date and time at which the resource was created.
array, required
Specifies the Open Banking account access data types. This is a list of the data clusters being consented by the PSU, and requested for authorisation with the PASP.
Allowed values:
ReadAccountsBasic, ReadAccountsDetail, ReadBalances, ReadTransactionsBasic, ReadTransactionsCredits, ReadTransactionsDebits, ReadTransactionsDetail, ReadOffers, ReadPAN, ReadProducts, ReadScheduledPaymentsDetail, ReadStatementsDetail, ReadBeneficiariesDetail, ReadBeneficiariesBasic, ReadDirectDebits, ReadStandingOrdersDetail, ReadStandingOrdersBasic, ReadParty, ReadPartyPSU
datetime, optional
Specified date and time the permissions will expire.
datetime, optional
Specified start date and time for the transaction query period. If this is not populated, the start date will be open ended, and data will be returned from the earliest available transaction.
datetime, optional
Specified end date and time for the transaction query period. If this is not populated, the end date will be open ended, and data will be returned to the latest available transaction.
Can raise:
ResourceInvalidFormat
hash, required
The Risk section is sent by the initiating party to the PASP. It is used to specify additional details for risk scoring for Account Info.
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
Destroy
If the PSU revokes consent to data access with the TPP, the TPP must delete the account-access-consent resource with the PASP as soon as is practically possible.
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.pzF03AvjhHVr2K38ougmjkVTkal1qxd1Mx6952xNEgSWT32c42-sf1Le8nUr1zhr8qahsDwoBVe91zfLlHOj7w7-HL7hUV1CVbxnthA4ETkv8vquKQyB8QQHUxMa1oHabXf_ePYCyunJcnGwovpfR-mrgzcTokBK-i2Ax1ihdhefjWxJF2O4RfkSSjXlwoO9egBuOtQZTaJLxiIr7xXWFNW7Ya16bSGTiQGt5bnwTjCWT8Hj-dswRxzOeyqHsnquUnPfpC9xCy6w5LVY-mX7rUXiddQ8nPl4N9OYGn0P4mr9IiiRUn2KgjhuIRlBKOGMnfrMcz1Le1M47uKpQmDzjw' \
-X DELETE "/api/:provider_code/open-banking/v3.1/aisp/account-access-consents/:consent_id"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.pzF03AvjhHVr2K38ougmjkVTkal1qxd1Mx6952xNEgSWT32c42-sf1Le8nUr1zhr8qahsDwoBVe91zfLlHOj7w7-HL7hUV1CVbxnthA4ETkv8vquKQyB8QQHUxMa1oHabXf_ePYCyunJcnGwovpfR-mrgzcTokBK-i2Ax1ihdhefjWxJF2O4RfkSSjXlwoO9egBuOtQZTaJLxiIr7xXWFNW7Ya16bSGTiQGt5bnwTjCWT8Hj-dswRxzOeyqHsnquUnPfpC9xCy6w5LVY-mX7rUXiddQ8nPl4N9OYGn0P4mr9IiiRUn2KgjhuIRlBKOGMnfrMcz1Le1M47uKpQmDzjw' \
-X DELETE "/api/:provider_code/open-banking/v3.1/aisp/account-access-consents/:consent_id"
Request
DELETE
/api/:provider_code/open-banking/v3.1/aisp/account-access-consents/:consent_id
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
string, required
Unique identification as assigned to identify the account access consent resource.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
Refresh
A lot of PASP's can not return imediately all AIS information. Call the POST /refresh endpoint before GET /accounts .
TPP should await success or fail final status. TPP may retrieve status by calling GET /refresh_status.
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.eyJEYXRhIjp7IkluaXRpYXRlZEJ5Q3VzdG9tZXIiOnRydWV9fQ.HA6npUeX9m1jpz_k7kTmROk1hBdSS-vRRSz3n1wNNMLzJpYGWuWCRePDV4ZI0njhW-GlSe8tFb-W9Xycgbg-pwnEDC7HAlwan--NvtYgql0ld0pVPBxWhpLosRafSQggNp2zZeVKI3TZiI-beNNtvl85Nj0bJDTj1zX2a01_yNaCHsJ2DTEahX8_VFuWJLRyj4H-10e8wOUwBsCsdgp4_aoWZS72wwLSAEmq2wW9kccAmHCelt2ysVTSBk4OlYTfv2vsquxMATR2mcvYawMwry8--tkzmPtEmPyCT3Sd0WhjypQHsrCNvBCRdYiqM0we6L0U3Df5yI_MZ_aPFHOgBA' \
-X POST "/api/:provider_code/open-banking/v3.1/aisp/accounts/refresh"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.eyJEYXRhIjp7IkluaXRpYXRlZEJ5Q3VzdG9tZXIiOnRydWV9fQ.HA6npUeX9m1jpz_k7kTmROk1hBdSS-vRRSz3n1wNNMLzJpYGWuWCRePDV4ZI0njhW-GlSe8tFb-W9Xycgbg-pwnEDC7HAlwan--NvtYgql0ld0pVPBxWhpLosRafSQggNp2zZeVKI3TZiI-beNNtvl85Nj0bJDTj1zX2a01_yNaCHsJ2DTEahX8_VFuWJLRyj4H-10e8wOUwBsCsdgp4_aoWZS72wwLSAEmq2wW9kccAmHCelt2ysVTSBk4OlYTfv2vsquxMATR2mcvYawMwry8--tkzmPtEmPyCT3Sd0WhjypQHsrCNvBCRdYiqM0we6L0U3Df5yI_MZ_aPFHOgBA' \
-X POST "/api/:provider_code/open-banking/v3.1/aisp/accounts/refresh"
Example of request
{"Data":{"InitiatedByCustomer":true}}
{"Data":{"InitiatedByCustomer":true}}
Example of response
{"Data":{"Status":"Processing"},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/refresh/status"},"Meta":{"TotalPages":1}}
{"Data":{"Status":"Processing"},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/refresh/status"},"Meta":{"TotalPages":1}}
Request
POST
/api/:provider_code/open-banking/v3.1/aisp/accounts/refresh
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
boolean, optional
Defines whether the request was initiated by the user or by the AISP without user presence. AISPs can access the payment accounts information only a max of 4 times within 24 hours without the user presence, or whenever the payment service user is actively requesting such information.
Default value:
false
Can raise:
ActionNotAllowed, AccessExceeded, AccessExceeded
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
string, required
Specifies the status of refresh process.
Allowed values:
NotInitiated, Processing, FetchingFinished, FetchingFailed, PartiallyFailed
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
ActionNotAllowed
|
406 |
You're not allowed to perform this action. This might be a configuration problem or parameters incompatibility. |
TooEarly
|
425 |
The service is not ready to process the request. |
AccessExceeded
|
429 |
Exceeded the number of automatic requests for this action. |
AccessExceeded
|
429 |
Exceeded the number of automatic requests for this action. |
Status of Refresh
TPP can retrieve REFRESH process status by calling the GET /refresh_status endpoint.
TPP should await success final status before request AIS info (e.g. accounts, transactions, balances).
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.CRFtRQNgrO8JyXDd_h8IgHp9LVggdYNQ1yZeIQckj9Mq4AnmHYgKq1dgixFrYY2nnVgqKKA9PpUKif7o-JiINsHYpuznbxa_oZSPdSP3qPirOMIvlJIhbGJp_NQghGrFH-MqpsjYiatuMUWrkF7sEN7-vYVez_P2v4WpPHPNKyYF5PUoumW7FZGmQm-aNxD4sjknGeRSPihmgmy4HU4nlRPxe5Fgif_zBCpUeKt4BpysMdJcbpLL37KqyXDXLxS35KQ_yuddnjVf5lnrbwvc_VG0kXB4Osk1CKZpYqj66YRJ4noVMsA7AezbFFnTQxOFUcxL7Zmb-WboQ7bk5wBL8w' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/refresh/status"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.CRFtRQNgrO8JyXDd_h8IgHp9LVggdYNQ1yZeIQckj9Mq4AnmHYgKq1dgixFrYY2nnVgqKKA9PpUKif7o-JiINsHYpuznbxa_oZSPdSP3qPirOMIvlJIhbGJp_NQghGrFH-MqpsjYiatuMUWrkF7sEN7-vYVez_P2v4WpPHPNKyYF5PUoumW7FZGmQm-aNxD4sjknGeRSPihmgmy4HU4nlRPxe5Fgif_zBCpUeKt4BpysMdJcbpLL37KqyXDXLxS35KQ_yuddnjVf5lnrbwvc_VG0kXB4Osk1CKZpYqj66YRJ4noVMsA7AezbFFnTQxOFUcxL7Zmb-WboQ7bk5wBL8w' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/refresh/status"
Example of response
{"Data":{"Status":"FetchingFinished"},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/refresh/status"},"Meta":{"TotalPages":1}}
{"Data":{"Status":"FetchingFinished"},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/refresh/status"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/refresh/status
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
ResourceNotFound
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
string, required
Specifies the status of refresh process.
Allowed values:
NotInitiated, Processing, FetchingFinished, FetchingFailed, PartiallyFailed
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
Index
The first step for a TPP after an account request is authorised - is to call the GET /accounts endpoint.
A TPP will be given the full list of accounts (the AccountId(s)) that the PSU has authorised the TPP to access. The AccountId(s) returned may then be used to retrieve other resources for a specific AccountId. The selection of authorised accounts happens only at the PASP's interface.
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.gjHYPcNacKip4w5fS6xawbG2nJNoP-PFsAoVldRUEEx3rxBzTjC2UxonExd06fe67xj7bEWgD5zvtpB5xf-r09Y-ul9q-sAbswvgx5MgPsu8NwjKGJ1CX8iygZ9s2wcl5u35lrm_oxV_WQrXdLkXSmnOHalnlC_ebfnWbhUEp7d5zPEXUT5ziEQD_fakHG9Ggivf3FgA4KgUQrB3NWVQVGqwdvd5iAYqFghQgPjtRGHaZz5O_Pgq1Y7noVh4ZLlBMls4YtRjEMJUzjwKmMThuK5rIFEzFCspi9Tq3up9ZrbNawHYk7a_IDfQF1QNeTIzc46SBpXTZV8YZ7Dkebi5Lg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.gjHYPcNacKip4w5fS6xawbG2nJNoP-PFsAoVldRUEEx3rxBzTjC2UxonExd06fe67xj7bEWgD5zvtpB5xf-r09Y-ul9q-sAbswvgx5MgPsu8NwjKGJ1CX8iygZ9s2wcl5u35lrm_oxV_WQrXdLkXSmnOHalnlC_ebfnWbhUEp7d5zPEXUT5ziEQD_fakHG9Ggivf3FgA4KgUQrB3NWVQVGqwdvd5iAYqFghQgPjtRGHaZz5O_Pgq1Y7noVh4ZLlBMls4YtRjEMJUzjwKmMThuK5rIFEzFCspi9Tq3up9ZrbNawHYk7a_IDfQF1QNeTIzc46SBpXTZV8YZ7Dkebi5Lg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts"
Example of response
{"Data":{"Account":[{"AccountId":"22289","Status":"Enabled","StatusUpdateDateTime":"2019-01-01T06:06:06+00:00","Currency":"GBP","AccountType":"Personal","AccountSubType":"CurrentAccount","Description":"Description of account","Nickname":"Bills","OpeningDate":"2019-01-01","MaturityDate":"2019-01-01","SwitchStatus":"processing","Account":[{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200110203345","Name":"Mr Kevin","SecondaryIdentification":"00021"}],"Servicer":{"SchemeName":"UK.OBIE.BICFI","Identification":"80200110203345"}},{"AccountId":"31820","Status":"Enabled","StatusUpdateDateTime":"2018-01-01T06:06:06+00:00","Currency":"GBP","AccountType":"Personal","AccountSubType":"CurrentAccount","Nickname":"Household","Account":[{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200110203348","Name":"Mr Kevin"}]}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/"},"Meta":{"TotalPages":1}}
{"Data":{"Account":[{"AccountId":"22289","Status":"Enabled","StatusUpdateDateTime":"2019-01-01T06:06:06+00:00","Currency":"GBP","AccountType":"Personal","AccountSubType":"CurrentAccount","Description":"Description of account","Nickname":"Bills","OpeningDate":"2019-01-01","MaturityDate":"2019-01-01","SwitchStatus":"processing","Account":[{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200110203345","Name":"Mr Kevin","SecondaryIdentification":"00021"}],"Servicer":{"SchemeName":"UK.OBIE.BICFI","Identification":"80200110203345"}},{"AccountId":"31820","Status":"Enabled","StatusUpdateDateTime":"2018-01-01T06:06:06+00:00","Currency":"GBP","AccountType":"Personal","AccountSubType":"CurrentAccount","Nickname":"Household","Account":[{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200110203348","Name":"Mr Kevin"}]}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
array, required
Unambiguous identification of the account to which credit and debit entries are made.
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
FieldInvalid
string, optional
Specifies the status of account resource in code form.
Allowed values:
Enabled, Disabled, Deleted, ProForma, Pending
Can raise:
FieldInvalid
datetime, optional
Date and time at which the resource status was updated.
string, optional
Identification of the currency in which the account is held. Usage: Currency should only be used in case one and the same account number covers several currencies and the initiating party needs to identify which currency needs to be used for settlement on the account.
Can raise:
FieldInvalid, UnsupportedCurrency
string, optional
Specifies the type of account (personal or business).
Allowed values:
Business, Personal
Can raise:
FieldInvalid
string, optional
Specifies the sub type of account (product family group).
Allowed values:
ChargeCard, CreditCard, CurrentAccount, EMoney, Loan, Mortgage, PrePaidCard, Savings
Can raise:
FieldInvalid
string, optional
The nickname of the account, assigned by the account owner in order to provide an additional means of identification of the account.
Can raise:
FieldInvalid
string, optional
Specifies the description of the account type.
Can raise:
FieldInvalid
date, optional
Date on which the account and related basic services are effectively operational for the account owner.
date, optional
Maturity date for the account.
string, optional
The switch status for the account.
Can raise:
FieldInvalid
array, optional
Unambiguous identification of the account to which credit and debit entries are made.
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.PAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
string, optional
This is secondary identification of the account, as assigned by the account servicing institution. This can be used by building societies to additionally identify accounts with a roll number (in addition to a sort code and account number combination).
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
hash, optional
Party that manages the account on behalf of the account owner, that manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account.
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
string, required
Unique and unambiguous identification of the servicing institution.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |
Show
A TPP may retrieve the account information resources for the AccountId (which is retrieved in the call to GET /accounts).
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.UzI5bo7Ub2gDkSOkB2ZzUNplinjIvoR6Co3jdct14Py8TbGypDTeP8R73kubyJeOYKSuokO3cXMXM7T6yaac91SOjxf-RLn6W0Pu5fhkEFbYNg-sugAPf20hoHmyRjHmXCbF-2_HAWgmlO1VF0rKuJTW54Zd424VULeJ5gL1Gqhg8TM9To9vl-VrWXLYi9mEZZU7-I2woW0tRqxC62ANt9_EuNbakb7ixSnkmPdFVebKv1DrBfpBRSog1byi4T3P1TgH1HXwBNT6iBH0lgG5XVD1teyYIbnidwCpZC9w1Zxqwx1YJ-m1j7qPqakmS-i64a5TmYDUsAEaAPkGP87PRg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.UzI5bo7Ub2gDkSOkB2ZzUNplinjIvoR6Co3jdct14Py8TbGypDTeP8R73kubyJeOYKSuokO3cXMXM7T6yaac91SOjxf-RLn6W0Pu5fhkEFbYNg-sugAPf20hoHmyRjHmXCbF-2_HAWgmlO1VF0rKuJTW54Zd424VULeJ5gL1Gqhg8TM9To9vl-VrWXLYi9mEZZU7-I2woW0tRqxC62ANt9_EuNbakb7ixSnkmPdFVebKv1DrBfpBRSog1byi4T3P1TgH1HXwBNT6iBH0lgG5XVD1teyYIbnidwCpZC9w1Zxqwx1YJ-m1j7qPqakmS-i64a5TmYDUsAEaAPkGP87PRg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id"
Example of response
{"Data":{"Account":[{"AccountId":"22289","Status":"Enabled","StatusUpdateDateTime":"2019-01-01T06:06:06+00:00","Currency":"GBP","AccountType":"Personal","AccountSubType":"CurrentAccount","Description":"Description of account","Nickname":"Bills","OpeningDate":"2019-01-01","MaturityDate":"2019-01-01","SwitchStatus":"processing","Account":[{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200110203345","Name":"Mr Kevin","SecondaryIdentification":"00021"}],"Servicer":{"SchemeName":"UK.OBIE.BICFI","Identification":"80200110203345"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289"},"Meta":{"TotalPages":1}}
{"Data":{"Account":[{"AccountId":"22289","Status":"Enabled","StatusUpdateDateTime":"2019-01-01T06:06:06+00:00","Currency":"GBP","AccountType":"Personal","AccountSubType":"CurrentAccount","Description":"Description of account","Nickname":"Bills","OpeningDate":"2019-01-01","MaturityDate":"2019-01-01","SwitchStatus":"processing","Account":[{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200110203345","Name":"Mr Kevin","SecondaryIdentification":"00021"}],"Servicer":{"SchemeName":"UK.OBIE.BICFI","Identification":"80200110203345"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
ResourceNotFound
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
array, required
Unambiguous identification of the account to which credit and debit entries are made.
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
FieldInvalid
string, optional
Specifies the status of account resource in code form.
Allowed values:
Enabled, Disabled, Deleted, ProForma, Pending
Can raise:
FieldInvalid
datetime, optional
Date and time at which the resource status was updated.
string, optional
Identification of the currency in which the account is held. Usage: Currency should only be used in case one and the same account number covers several currencies and the initiating party needs to identify which currency needs to be used for settlement on the account.
Can raise:
FieldInvalid, UnsupportedCurrency
string, optional
Specifies the type of account (personal or business).
Allowed values:
Business, Personal
Can raise:
FieldInvalid
string, optional
Specifies the sub type of account (product family group).
Allowed values:
ChargeCard, CreditCard, CurrentAccount, EMoney, Loan, Mortgage, PrePaidCard, Savings
Can raise:
FieldInvalid
string, optional
The nickname of the account, assigned by the account owner in order to provide an additional means of identification of the account.
Can raise:
FieldInvalid
string, optional
Specifies the description of the account type.
Can raise:
FieldInvalid
date, optional
Date on which the account and related basic services are effectively operational for the account owner.
date, optional
Maturity date for the account.
string, optional
The switch status for the account.
Can raise:
FieldInvalid
array, optional
Unambiguous identification of the account to which credit and debit entries are made.
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.PAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
string, optional
This is secondary identification of the account, as assigned by the account servicing institution. This can be used by building societies to additionally identify accounts with a roll number (in addition to a sort code and account number combination).
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
hash, optional
Party that manages the account on behalf of the account owner, that manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account.
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
string, required
Unique and unambiguous identification of the servicing institution.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |
Transactions
An TPP may retrieve the transaction resource for a specific AccountId (which is retrieved in the call to GET /accounts).
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.QkIkB6bPAESpx5q8bdvyxc0ld6yoQk02LQ1OtxI_4wTbGmsrRWVFVIxwwrTGc_YL_2SOPWo1Mg9-wRAcTUfC9SAUs9z416Z4XNC0KMPUt-BxV5CxbXBANsgThovyhZV9OCZNegIMNgqJ73v6DiJKY20BPlVTdjUPmpayVCo8LbzPIQWF974fQwugg3isEs38kSpU_PnFEpmbWp2FBLBrod9T5drmApLHY6v3hcwLIZkZSKy7Rd1OBqOGHitRq4bOuMgdKLENyWRUpRPz_sZogOBVu7brzP8x7Zxj7yjvU7qY16o300hP-UUZ2YAvz5Lc0pa0vBSQpNeHV5UsVwAbgQ' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/transactions"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.QkIkB6bPAESpx5q8bdvyxc0ld6yoQk02LQ1OtxI_4wTbGmsrRWVFVIxwwrTGc_YL_2SOPWo1Mg9-wRAcTUfC9SAUs9z416Z4XNC0KMPUt-BxV5CxbXBANsgThovyhZV9OCZNegIMNgqJ73v6DiJKY20BPlVTdjUPmpayVCo8LbzPIQWF974fQwugg3isEs38kSpU_PnFEpmbWp2FBLBrod9T5drmApLHY6v3hcwLIZkZSKy7Rd1OBqOGHitRq4bOuMgdKLENyWRUpRPz_sZogOBVu7brzP8x7Zxj7yjvU7qY16o300hP-UUZ2YAvz5Lc0pa0vBSQpNeHV5UsVwAbgQ' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/transactions"
Example of response
{"Data":{"Transaction":[{"AccountId":"22289","TransactionId":"123","TransactionReference":"Ref 1","StatementReference":["some-ref"],"CreditDebitIndicator":"Credit","Status":"Booked","TransactionMutability":"Immutable","BookingDateTime":"2017-04-05T10:43:07+00:00","ValueDateTime":"2017-04-05T10:45:22+00:00","TransactionInformation":"Cash from Aubrey","Amount":{"Amount":"10.00","Currency":"GBP"},"ChargeAmount":{"Amount":"10.00","Currency":"GBP"},"CurrencyExchange":{"SourceCurrency":"EUR","TargetCurrency":"GBP","UnitCurrency":"GBP","ExchangeRate":"0.92","ContractIdentification":"some-identification","QuotationDate":"2017-04-05","InstructedAmount":{"Amount":"10.00","Currency":"GBP"}},"BankTransactionCode":{"Code":"ReceivedCreditTransfer","SubCode":"DomesticCreditTransfer"},"ProprietaryBankTransactionCode":{"Code":"Transfer","Issuer":"AlphaBank"},"Balance":{"Amount":{"Amount":"230.00","Currency":"GBP"},"Type":"InterimBooked","CreditDebitIndicator":"Credit"},"MerchantDetails":{"MerchantName":"Merchant name","MerchantCategoryCode":"some-code"},"CreditorAgent":{"SchemeName":"UK.OBIE.BICFI","Identification":"GB29NWBK60161331926819","Name":"Creditor Agent Name","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":"10 Downing St, Westminster, London SW1A 2AA, United Kingdom"}},"CreditorAccount":{"SchemeName":"UK.OBIE.IBAN","Identification":"GB29NWBK60161331926819","Name":"Creditor Account Name","SecondaryIdentification":"12-34-56"},"DebtorAgent":{"SchemeName":"UK.OBIE.BICFI","Identification":"GB29NWBK60161331926810","Name":"Debtor Agent Name","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":"10 Downing St, Westminster, London SW1A 2AA, United Kingdom"}},"DebtorAccount":{"SchemeName":"UK.OBIE.IBAN","Identification":"GB29NWBK60161331926810","Name":"Debtor Account Name","SecondaryIdentification":"22-33-55"},"CardInstrument":{"CardSchemeName":"Debit Card","AuthorizationType":"OAuth","Name":"Card Name","Identification":"12-34-56"},"SupplementaryData":{}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/transactions/"},"Meta":{"TotalPages":1,"FirstAvailableDateTime":"2017-05-03T00:00:00+00:00","LastAvailableDateTime":"2017-12-03T00:00:00+00:00"}}
{"Data":{"Transaction":[{"AccountId":"22289","TransactionId":"123","TransactionReference":"Ref 1","StatementReference":["some-ref"],"CreditDebitIndicator":"Credit","Status":"Booked","TransactionMutability":"Immutable","BookingDateTime":"2017-04-05T10:43:07+00:00","ValueDateTime":"2017-04-05T10:45:22+00:00","TransactionInformation":"Cash from Aubrey","Amount":{"Amount":"10.00","Currency":"GBP"},"ChargeAmount":{"Amount":"10.00","Currency":"GBP"},"CurrencyExchange":{"SourceCurrency":"EUR","TargetCurrency":"GBP","UnitCurrency":"GBP","ExchangeRate":"0.92","ContractIdentification":"some-identification","QuotationDate":"2017-04-05","InstructedAmount":{"Amount":"10.00","Currency":"GBP"}},"BankTransactionCode":{"Code":"ReceivedCreditTransfer","SubCode":"DomesticCreditTransfer"},"ProprietaryBankTransactionCode":{"Code":"Transfer","Issuer":"AlphaBank"},"Balance":{"Amount":{"Amount":"230.00","Currency":"GBP"},"Type":"InterimBooked","CreditDebitIndicator":"Credit"},"MerchantDetails":{"MerchantName":"Merchant name","MerchantCategoryCode":"some-code"},"CreditorAgent":{"SchemeName":"UK.OBIE.BICFI","Identification":"GB29NWBK60161331926819","Name":"Creditor Agent Name","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":"10 Downing St, Westminster, London SW1A 2AA, United Kingdom"}},"CreditorAccount":{"SchemeName":"UK.OBIE.IBAN","Identification":"GB29NWBK60161331926819","Name":"Creditor Account Name","SecondaryIdentification":"12-34-56"},"DebtorAgent":{"SchemeName":"UK.OBIE.BICFI","Identification":"GB29NWBK60161331926810","Name":"Debtor Agent Name","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":"10 Downing St, Westminster, London SW1A 2AA, United Kingdom"}},"DebtorAccount":{"SchemeName":"UK.OBIE.IBAN","Identification":"GB29NWBK60161331926810","Name":"Debtor Account Name","SecondaryIdentification":"22-33-55"},"CardInstrument":{"CardSchemeName":"Debit Card","AuthorizationType":"OAuth","Name":"Card Name","Identification":"12-34-56"},"SupplementaryData":{}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/transactions/"},"Meta":{"TotalPages":1,"FirstAvailableDateTime":"2017-05-03T00:00:00+00:00","LastAvailableDateTime":"2017-12-03T00:00:00+00:00"}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/transactions
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
ResourceNotFound
fromBookingDateTime
(query)
datetime, optional
Specifies start date and time for filtering of the Transaction records on the Transaction/BookingDateTime field.
toBookingDateTime
(query)
datetime, optional
Specifies end date and time for filtering of the Transaction records on the Transaction/BookingDateTime field.
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
array, required
Provides further details on an entry in the report.
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
FieldInvalid
string, optional
Unique identifier for the transaction within a servicing institution. This identifier is both unique and immutable.
Can raise:
FieldInvalid
array, optional
Unique reference for the statement. This reference may be optionally populated if available.
string, required
Indicates whether the transaction is a credit or a debit entry.
Allowed values:
Credit, Debit
Can raise:
FieldInvalid
string, required
Status of a transaction entry on the books of the account servicer.
Allowed values:
Pending, Rejected, Booked
Can raise:
FieldInvalid
string, optional
Specifies the Mutability of the Transaction record.
Can raise:
FieldInvalid
datetime, required
Date and time when a transaction entry is posted to an account on the account servicer's books. Usage: Booking date is the expected booking date, unless the status is booked, in which case it is the actual booking date.
datetime, optional
Date and time at which assets become available to the account owner in case of a credit entry, or cease to be available to the account owner in case of a debit transaction entry. Usage: If transaction entry status is pending and value date is present, then the value date refers to an expected/requested value date. For transaction entries subject to availability/float and for which availability information is provided, the value date must not be used. In this case the availability component identifies the number of availability days.
string, optional
Unique reference for the transaction. This reference is optionally populated, and may as an example be the FPID in the Faster Payments context.
Can raise:
FieldInvalid
string, optional
Further details of the transaction. This is the transaction narrative, which is unstructured text.
Can raise:
FieldInvalid
hash, required
Amount of money in the cash transaction entry.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
Can raise:
FieldInvalid, UnsupportedCurrency
hash, optional
Transaction charges to be paid by the charge bearer.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
Can raise:
FieldInvalid, UnsupportedCurrency
hash, optional
Set of elements used to provide details on the currency exchange.
string, required
Currency from which an amount is to be converted in a currency conversion.
Can raise:
FieldInvalid
string, optional
Currency into which an amount is to be converted in a currency conversion.
Can raise:
FieldInvalid
string, optional
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
string, required
Factor used to convert an amount from one currency into another. This reflects the price at which one currency was bought with another currency. Usage: ExchangeRate expresses the ratio between UnitCurrency and QuotedCurrency (ExchangeRate = UnitCurrency/QuotedCurrency).
Can raise:
FieldInvalid
string, optional
Unique identification to unambiguously identify the foreign exchange contract.
Can raise:
FieldInvalid
date, optional
Date and time at which an exchange rate is quoted.
hash, optional
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
Can raise:
FieldInvalid, UnsupportedCurrency
hash, optional
Set of elements used to fully identify the type of underlying transaction resulting in an entry.
string, required
Specifies the family within a domain.
Can raise:
FieldInvalid
string, required
Specifies the sub-product family within a specific family.
Can raise:
FieldInvalid
ProprietaryBankTransactionCode
hash, optional
Set of elements to fully identify a proprietary bank transaction code.
string, required
Proprietary bank transaction code to identify the underlying transaction.
Can raise:
FieldInvalid
string, required
Identification of the issuer of the proprietary bank transaction code.
Can raise:
FieldInvalid
hash, optional
Set of elements used to define the balance as a numerical representation of the net increases and decreases in an account after a transaction entry is applied to the account.
hash, required
Amount of money of the cash balance after a transaction entry is applied to the account.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
Can raise:
FieldInvalid, UnsupportedCurrency
string, required
Balance type, in a coded form.
Can raise:
FieldInvalid
string, required
Indicates whether the balance is a credit or a debit balance. Usage: A zero balance is considered to be a credit balance.
Allowed values:
Credit, Debit
Can raise:
FieldInvalid
hash, optional
Details of the merchant involved in the transaction.
string, optional
Name by which the merchant is known.
Can raise:
FieldInvalid
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Can raise:
FieldInvalid
hash, optional
Financial institution servicing an account for the creditor.
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
string, optional
Unique and unambiguous identification of a financial institution or a branch of a financial institution.
Can raise:
FieldInvalid
string, optional
Name by which an agent is known and which is usually used to identify that agent.
Can raise:
FieldInvalid
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
string, optional
Identification of a division of a large organisation or building.
Can raise:
FieldInvalid
string, optional
Identification of a sub-division of a large organisation or building.
Can raise:
FieldInvalid
string, optional
Name of a street or thoroughfare.
Can raise:
FieldInvalid
string, optional
Number that identifies the position of a building on a street.
Can raise:
FieldInvalid
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Can raise:
FieldInvalid
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Can raise:
FieldInvalid
string, optional
Identifies a subdivision of a country such as state, region, county.
Can raise:
FieldInvalid
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
string, optional
Information that locates and identifies a specific address, as defined by postal services, presented in free format text.
Can raise:
FieldInvalid
hash, optional
Unambiguous identification of the account of the creditor, in the case of a debit transaction.
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.PAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Can raise:
FieldInvalid
string, optional
This is secondary identification of the account, as assigned by the account servicing institution. This can be used by building societies to additionally identify accounts with a roll number (in addition to a sort code and account number combination).
Can raise:
FieldInvalid
hash, optional
Financial institution servicing an account for the debtor.
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Can raise:
FieldInvalid
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
string, optional
Identification of a division of a large organisation or building.
Can raise:
FieldInvalid
string, optional
Identification of a sub-division of a large organisation or building.
Can raise:
FieldInvalid
string, optional
Name of a street or thoroughfare.
Can raise:
FieldInvalid
string, optional
Number that identifies the position of a building on a street.
Can raise:
FieldInvalid
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Can raise:
FieldInvalid
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Can raise:
FieldInvalid
string, optional
Identifies a subdivision of a country such as state, region, county.
Can raise:
FieldInvalid
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
string, optional
Information that locates and identifies a specific address, as defined by postal services, presented in free format text.
Can raise:
FieldInvalid
hash, optional
Unambiguous identification of the account of the debtor, in the case of a credit transaction.
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.PAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Can raise:
FieldInvalid
string, optional
This is secondary identification of the account, as assigned by the account servicing institution. This can be used by building societies to additionally identify accounts with a roll number (in addition to a sort code and account number combination).
Can raise:
FieldInvalid
hash, optional
Set of elements to describe the card instrument used in the transaction.
string, required
Name of the card scheme.
Can raise:
FieldInvalid
string, optional
The card authorisation type.
Can raise:
FieldInvalid
string, optional
Name of the cardholder using the card instrument.
Can raise:
FieldInvalid
string, optional
Identification assigned by an institution to identify the card instrument used in the transaction. This identification is known by the account owner, and may be masked.
Can raise:
FieldInvalid
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |
Balances
A TPP may retrieve the account balance information resource for a specific AccountId (which is retrieved in the call to GET /accounts).
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.AnLRPnZMlXz36J8Z8RinYo64h1vUmbjcgDmwpUxGZsDBQn6_JxVgwtaKKprodrl-SYURnsuctR9-fGoqPZbc54vYTOiSHMB2eWxv8DbzOxfBo5xaEAXwMUB9dliWyesopXbINLcSTbgSEHSgZrEybZLe9b4ScmFVT81RADUJgU4Jds2WcRIJZ42rKNCbWBewjSauKVIhGrJD5Iq18kjoIrDwODPw0o9k9eUCaMbvRlfKt91K-sZxXm7VeT73Uzg5n7ldLQt-AbmA0ZFsNGdaMDdyHkp3GxD2lbqMIQz1dXTU1dvgiClrnWStYXXOwyxKhZYDb-M3ewwIkV24F4vDkA' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/balances"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.AnLRPnZMlXz36J8Z8RinYo64h1vUmbjcgDmwpUxGZsDBQn6_JxVgwtaKKprodrl-SYURnsuctR9-fGoqPZbc54vYTOiSHMB2eWxv8DbzOxfBo5xaEAXwMUB9dliWyesopXbINLcSTbgSEHSgZrEybZLe9b4ScmFVT81RADUJgU4Jds2WcRIJZ42rKNCbWBewjSauKVIhGrJD5Iq18kjoIrDwODPw0o9k9eUCaMbvRlfKt91K-sZxXm7VeT73Uzg5n7ldLQt-AbmA0ZFsNGdaMDdyHkp3GxD2lbqMIQz1dXTU1dvgiClrnWStYXXOwyxKhZYDb-M3ewwIkV24F4vDkA' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/balances"
Example of response
{"Data":{"Balance":[{"AccountId":"22289","Amount":{"Amount":"1230.00","Currency":"GBP"},"CreditDebitIndicator":"Credit","Type":"InterimAvailable","DateTime":"2017-04-05T10:43:07+00:00","CreditLine":[{"Included":true,"Amount":{"Amount":"1000.00","Currency":"GBP"},"Type":"Temporary"}]},{"AccountId":"31820","Amount":{"Amount":"57.36","Currency":"GBP"},"CreditDebitIndicator":"Debit","Type":"InterimBooked","DateTime":"2017-05-02T14:22:09+00:00"}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/balances/"},"Meta":{"TotalPages":1}}
{"Data":{"Balance":[{"AccountId":"22289","Amount":{"Amount":"1230.00","Currency":"GBP"},"CreditDebitIndicator":"Credit","Type":"InterimAvailable","DateTime":"2017-04-05T10:43:07+00:00","CreditLine":[{"Included":true,"Amount":{"Amount":"1000.00","Currency":"GBP"},"Type":"Temporary"}]},{"AccountId":"31820","Amount":{"Amount":"57.36","Currency":"GBP"},"CreditDebitIndicator":"Debit","Type":"InterimBooked","DateTime":"2017-05-02T14:22:09+00:00"}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/balances/"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/balances
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
ResourceNotFound
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
array, required
Set of elements used to define the balance details.
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
FieldInvalid
hash, required
Amount of money of the cash balance.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
Can raise:
FieldInvalid, UnsupportedCurrency
string, required
Indicates whether the balance is a credit or a debit balance. Usage: A zero balance is considered to be a credit balance.
Allowed values:
Credit, Debit
Can raise:
FieldInvalid
string, required
Balance type, in a coded form.
Allowed values:
ClosingAvailable, ClosingBooked, ClosingCleared, Expected, ForwardAvailable, Information, InterimAvailable, InterimBooked, InterimCleared, OpeningAvailable, OpeningBooked, OpeningCleared, PreviouslyClosedBooked
Can raise:
FieldInvalid
datetime, required
Indicates the date (and time) of the balance.
array, optional
Set of elements used to provide details on the credit line.
boolean, required
Indicates whether or not the credit line is included in the balance of the account. Usage: If not present, credit line is not included in the balance amount of the account.
hash, optional
Amount of money of the credit line.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
Can raise:
FieldInvalid, UnsupportedCurrency
string, optional
Limit type, in a coded form.
Allowed values:
Available, Credit, Emergency, Pre-Agreed, Temporary
Can raise:
FieldInvalid
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |
Beneficiaries
An AISP may retrieve the account beneficiaries information resource for a specific AccountId
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.wa8TAWZUrVRcixAInF32uQHDj3ibrNA7Z5JzdrsC6FZrdTDHU-CQUPKDM2T9XzYcMS2kMZX2H-2vxU4o9BBM9OD5ns7hDZp7YPmJobrXN1FfX6GbCYhlUo4zGttQb5vaAv-Iq4buakjx8p1_CTs4C4qNmTbDPeopGqHqNMownDUcmoHZWTq6fpKUBp9zQiZGbAb-uoJBNcFZv_l--0AhsIsbsgM-2ehYMXNuZoKwYuPgvMZuehcB_szsa1JsKR7Yb3AciqhUmBndiqcsLGWRWp7jnEkpUCS_3C4k-II4gydhafcSEqLMWzl4JFehRq_Q4yuWefuYNEncqHIHH5Srig' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/beneficiaries"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.wa8TAWZUrVRcixAInF32uQHDj3ibrNA7Z5JzdrsC6FZrdTDHU-CQUPKDM2T9XzYcMS2kMZX2H-2vxU4o9BBM9OD5ns7hDZp7YPmJobrXN1FfX6GbCYhlUo4zGttQb5vaAv-Iq4buakjx8p1_CTs4C4qNmTbDPeopGqHqNMownDUcmoHZWTq6fpKUBp9zQiZGbAb-uoJBNcFZv_l--0AhsIsbsgM-2ehYMXNuZoKwYuPgvMZuehcB_szsa1JsKR7Yb3AciqhUmBndiqcsLGWRWp7jnEkpUCS_3C4k-II4gydhafcSEqLMWzl4JFehRq_Q4yuWefuYNEncqHIHH5Srig' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/beneficiaries"
Example of response
{"Data":{"Beneficiary":[{"AccountId":"22289","BeneficiaryId":"Ben1","Reference":"Towbar Club","CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200112345678","Name":"Mrs Juniper"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/beneficiaries"},"Meta":{"TotalPages":1}}
{"Data":{"Beneficiary":[{"AccountId":"22289","BeneficiaryId":"Ben1","Reference":"Towbar Club","CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200112345678","Name":"Mrs Juniper"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/beneficiaries"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/beneficiaries
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
ResourceNotFound
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
array, required
Beneficiaries wrapper.
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
string, optional
A unique and immutable identifier used to identify the beneficiary resource. This identifier has no meaning to the account owner.
string, optional
Specifies the Beneficiary Type.
string, optional
Additional information that cannot be captured in the structured fields and/or any other specific block.
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
hash, optional
Provides the details to identify the beneficiary account.
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.PAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
string, optional
This is secondary identification of the account, as assigned by the account servicing institution. This can be used by building societies to additionally identify accounts with a roll number (in addition to a sort code and account number combination).
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
hash, optional
Party that manages the account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account. This is the servicer of the beneficiary account.
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Can raise:
FieldInvalid
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
string, optional
dentifies the nature of the postal address.
Can raise:
FieldInvalid
string, optional
Identification of a division of a large organisation or building.
Can raise:
FieldInvalid
string, optional
Identification of a sub-division of a large organisation or building.
Can raise:
FieldInvalid
string, optional
Name of a street or thoroughfare.
Can raise:
FieldInvalid
string, optional
Number that identifies the position of a building on a street.
Can raise:
FieldInvalid
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Can raise:
FieldInvalid
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Can raise:
FieldInvalid
string, optional
Identifies a subdivision of a country such as state, region, county.
Can raise:
FieldInvalid
string, optional
Nation with its own government. (ISO 3166-1 alpha-2 code)
Can raise:
FieldInvalid, CountryNameInvalid
string, optional
Information that locates and identifies a specific address, as defined by postal services, presented in free format text.
Can raise:
FieldInvalid
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |
Direct Debits
An PASP must provide this endpoint for AISPs to retrieve the direct-debits for a specific account identified by AccountId.
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.cDo9UoFmY48mh1yAegENFtrLU8PNs9gfzTjAbbxvDGLTM1cFOyXnp-8TnOJxtTt31aeM3jw4GEvQ0QIbqSzriUATwATnDN7EgW7bwF1r333uSaDRbto_UvUr4lSa6VVLl_4xR1dB_VgF1UEvKKCVD8zjZy_KMjYER_hlYIL7HBif1WpWgjZ_e4i6oq4kSJ8X2vOR8vluSoizaixqWbcLu2ImPi_Lw5NkFbPgzycMwcDQvhKuLYOxffF-kN6yyLUT4GtPTBHUeVbTTPXO04KiknXvuVH9m3WOo_koazMNrYV9y51eJ4ODGm2zSH1F_s3BQGTDS1_-EQ7SASu0OeuhQg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/direct-debits"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.cDo9UoFmY48mh1yAegENFtrLU8PNs9gfzTjAbbxvDGLTM1cFOyXnp-8TnOJxtTt31aeM3jw4GEvQ0QIbqSzriUATwATnDN7EgW7bwF1r333uSaDRbto_UvUr4lSa6VVLl_4xR1dB_VgF1UEvKKCVD8zjZy_KMjYER_hlYIL7HBif1WpWgjZ_e4i6oq4kSJ8X2vOR8vluSoizaixqWbcLu2ImPi_Lw5NkFbPgzycMwcDQvhKuLYOxffF-kN6yyLUT4GtPTBHUeVbTTPXO04KiknXvuVH9m3WOo_koazMNrYV9y51eJ4ODGm2zSH1F_s3BQGTDS1_-EQ7SASu0OeuhQg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/direct-debits"
Example of response
{"Data":{"DirectDebit":[{"AccountId":"22289","DirectDebitId":"DD03","MandateIdentification":"Caravanners","DirectDebitStatusCode":"Active","Name":"Towbar Club 3 - We Love Towbars","PreviousPaymentDateTime":"2017-04-05T10:43:07+00:00","PreviousPaymentAmount":{"Amount":"0.57","Currency":"GBP"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/direct-debits"},"Meta":{"TotalPages":1}}
{"Data":{"DirectDebit":[{"AccountId":"22289","DirectDebitId":"DD03","MandateIdentification":"Caravanners","DirectDebitStatusCode":"Active","Name":"Towbar Club 3 - We Love Towbars","PreviousPaymentDateTime":"2017-04-05T10:43:07+00:00","PreviousPaymentAmount":{"Amount":"0.57","Currency":"GBP"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/direct-debits"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/direct-debits
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
ResourceNotFound
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
array, required
DirectDebits wrapper.
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
string, optional
A unique and immutable identifier used to identify the direct debit resource. This identifier has no meaning to the account owner.
string, required
Direct Debit reference. For AUDDIS service users provide Core Reference. For non AUDDIS service users provide Core reference if possible or last used reference.
string, optional
Specifies the status of the direct debit in code form.
string, required
Name of Service User.
string, optional
Regularity with which direct debit instructions are to be created and processed
datetime, optional
Date of most recent direct debit collection.
hash, optional
The amount of the most recent direct debit collection.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217.
Can raise:
FieldInvalid, UnsupportedCurrency
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |
Standing Orders
An AISP may retrieve the standing-order resource for a specific AccountId
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.NCFgwecCwuM5Djkcb_1EN92JuJaG4D-rtqoHSVro_Wo9fVxZpF89ay-T9TSB46VuTv0uKK6Cy1dBb53upmTOVSRRyWDt5kRKNmoqClEEiMNN2YgZ1AXXNUoDwURrir970uNOBSAwDAJxMG46s5pHDOnPkn3Z0f9wNmvFuqOeyKu_gBCLLhAFBAQ60Ybv_dVSOnaxCLLBsxd5KQC6FTxJwr4XfcWBkFeoDVD68xbX6LQuEVqvzZHT4_iXDo0Qsz36WTVKUp004cVXKGBcLuG5e7w8LnM8nIXnxWHSlo6cE5ZISLomRNtQjrYQEfWPerhWFoabiOO6rGvokzO5J_0v5Q' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/standing-orders"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.NCFgwecCwuM5Djkcb_1EN92JuJaG4D-rtqoHSVro_Wo9fVxZpF89ay-T9TSB46VuTv0uKK6Cy1dBb53upmTOVSRRyWDt5kRKNmoqClEEiMNN2YgZ1AXXNUoDwURrir970uNOBSAwDAJxMG46s5pHDOnPkn3Z0f9wNmvFuqOeyKu_gBCLLhAFBAQ60Ybv_dVSOnaxCLLBsxd5KQC6FTxJwr4XfcWBkFeoDVD68xbX6LQuEVqvzZHT4_iXDo0Qsz36WTVKUp004cVXKGBcLuG5e7w8LnM8nIXnxWHSlo6cE5ZISLomRNtQjrYQEfWPerhWFoabiOO6rGvokzO5J_0v5Q' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/standing-orders"
Example of response
{"Data":{"StandingOrder":[{"AccountId":"22289","StandingOrderId":"Ben3","Frequency":"EvryWorkgDay","Reference":"Towbar Club 2 - We Love Towbars","FirstPaymentDateTime":"2017-08-12T00:00:00+00:00","FirstPaymentAmount":{"Amount":"0.57","Currency":"GBP"},"NextPaymentDateTime":"2017-08-13T00:00:00+00:00","NextPaymentAmount":{"Amount":"0.56","Currency":"GBP"},"FinalPaymentDateTime":"2027-08-12T00:00:00+00:00","FinalPaymentAmount":{"Amount":"0.56","Currency":"GBP"},"StandingOrderStatusCode":"Active","CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200112345678","Name":"Mrs Juniper"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/standing_orders"},"Meta":{"TotalPages":1}}
{"Data":{"StandingOrder":[{"AccountId":"22289","StandingOrderId":"Ben3","Frequency":"EvryWorkgDay","Reference":"Towbar Club 2 - We Love Towbars","FirstPaymentDateTime":"2017-08-12T00:00:00+00:00","FirstPaymentAmount":{"Amount":"0.57","Currency":"GBP"},"NextPaymentDateTime":"2017-08-13T00:00:00+00:00","NextPaymentAmount":{"Amount":"0.56","Currency":"GBP"},"FinalPaymentDateTime":"2027-08-12T00:00:00+00:00","FinalPaymentAmount":{"Amount":"0.56","Currency":"GBP"},"StandingOrderStatusCode":"Active","CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"80200112345678","Name":"Mrs Juniper"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/standing_orders"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/standing-orders
Headers
Header |
Type |
Description |
Content-Type
|
string, optional
|
The media type of the body of the request.
Default value:
application/json
|
x-fapi-interaction-id
|
string, optional
|
An RFC4122 UID used as a correlation Id.
|
Authorization
|
string, required
|
Standard HTTP Header; Allows Credentials to be provided to the Authorisation / Resource Server depending on the type of resource being requested. For OAuth 2.0 / OIDC, this comprises of either the Basic / Bearer Authentication Schemes.
Can raise:
HeaderMissing, HeaderInvalid, ResourceNotFound, Forbidden
|
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
ResourceNotFound
Response headers
Header |
Type |
Description |
Content-Type
|
string, required
|
The media type of the body of the request.
|
x-fapi-interaction-id
|
string, required
|
An RFC4122 UID used as a correlation Id. If provided, the PASP must "play back" this value in the x-fapi-interaction-id response header.
|
Retry-After
|
integer, optional
|
Amount of time in seconds after which Salt Edge OB KSA Compliance Solution resends the previously failed request.
|
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
array, required
Standing Orders wrapper.
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
string, optional
A unique and immutable identifier used to identify the standing order resource. This identifier has no meaning to the account owner.
string, required
This is a specific format of describing the rule for creating the payments of a standing order.
It should comply with one of the permitted patterns. Full pattern represented as a regular expression which can be used for validating the value provided in this field:
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$|^(QtrDay:(ENGLISH|SCOTTISH|RECEIVED))$
Can raise:
UnsupportedFrequency
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
datetime, optional
The date on which the first payment for a Standing Order schedule will be made.
hash, optional
The amount of the first Standing Order.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217.
datetime, optional
The date on which the next payment for a Standing Order schedule will be made.
hash, optional
The amount of the next Standing Order.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217.
datetime, optional
The date on which the final payment for a Standing Order schedule will be made.
hash, optional
The amount of the final Standing Order.
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
string, required
A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217.
string, optional
Specifies the status of the standing order in code form.
string, optional
Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date.
hash, optional
Party that manages the account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account. This is the servicer of the beneficiary account.
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
string, required
Unique and unambiguous identification of the servicing institution.
Can raise:
FieldInvalid
hash, optional
Provides the details to identify the beneficiary account.
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.PAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
string, required
Beneficiary account identification.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the PASP's online channels. Note, the account name is not the product name or the nickname of the account.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
string, optional
This is secondary identification of the account, as assigned by the account servicing institution. This can be used by building societies to additionally identify accounts with a roll number (in addition to a sort code and account number combination).
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
string, optional
Additional information that cannot be captured in the structured fields and/or any other specific block.
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |
Party
The PASP must return details on the account owner:
In the case of a business - this will be the details of the business.
In the case of a joint account - this will be the party that has given authorisation to the AISP to view the account. If the AISP wishes to access details of other parties linked to the AccountId, the AISP must go through an authorisation flow with the other parties.
CURL
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.U_5TiFZnh9i1QR959QUbgq_EnSZIePQkYqOYLNC6u5dwopgSIjyXqhcck_DMjL0truX15fSQKSZ9FaMfqsTHKRETqWfa55SyYbjwcOxrr6P2ASRfH24uhvtiZ6vTT5VhpmrAe8ikhwNGYEA66laxknIc2-HUNTl-fy4bmQci2X8objW2A7gu3CiE7yy5fnOyy0YpGKVKjzzPFOT20pzWxTOKBVSNS7If1KC0lDrnLG9gzT6jL_Fqdq9-mbjzYg7bf_eM9tjDG5Plq96WDwZ6KLWTp62ZhK1mkCGtHvqNyl6JKZIbcMJfyVajuuxdA-x1Hac8OSU1nEro9sQi-mg_Zg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/party"
curl -i \
-H "Authorization: Bearer Az90SAOJklae" \
-H "x-fapi-interaction-id: some-uuid" \
-H "Content-Type: application/json" \
-d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.U_5TiFZnh9i1QR959QUbgq_EnSZIePQkYqOYLNC6u5dwopgSIjyXqhcck_DMjL0truX15fSQKSZ9FaMfqsTHKRETqWfa55SyYbjwcOxrr6P2ASRfH24uhvtiZ6vTT5VhpmrAe8ikhwNGYEA66laxknIc2-HUNTl-fy4bmQci2X8objW2A7gu3CiE7yy5fnOyy0YpGKVKjzzPFOT20pzWxTOKBVSNS7If1KC0lDrnLG9gzT6jL_Fqdq9-mbjzYg7bf_eM9tjDG5Plq96WDwZ6KLWTp62ZhK1mkCGtHvqNyl6JKZIbcMJfyVajuuxdA-x1Hac8OSU1nEro9sQi-mg_Zg' \
-X GET "/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/party"
Example of response
{"Data":{"Party":[{"PartyId":"PABC123","PartyType":"Sole","Name":"Semiotec","FullLegalName":"Semiotec Limited","LegalStructure":"UK.OBIE.PrivateLimitedCompany","BeneficialOwnership":true,"AccountRole":"UK.OBIE.Principal","EmailAddress":"contact@semiotec.co.jp","Phone":"+44-00000000","Mobile":"+44-00000001","Relationships":{"Account":{"Related":"https://api.alphabank.com/open-banking/v4.0/aisp/accounts/22289","Id":"22289"}},"Address":{"AddressType":"Business","StreetName":"Street","BuildingNumber":"15","PostCode":"NW1 1AB","TownName":"London","Country":"GB"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/party"},"Meta":{"TotalPages":1}}
{"Data":{"Party":[{"PartyId":"PABC123","PartyType":"Sole","Name":"Semiotec","FullLegalName":"Semiotec Limited","LegalStructure":"UK.OBIE.PrivateLimitedCompany","BeneficialOwnership":true,"AccountRole":"UK.OBIE.Principal","EmailAddress":"contact@semiotec.co.jp","Phone":"+44-00000000","Mobile":"+44-00000001","Relationships":{"Account":{"Related":"https://api.alphabank.com/open-banking/v4.0/aisp/accounts/22289","Id":"22289"}},"Address":{"AddressType":"Business","StreetName":"Street","BuildingNumber":"15","PostCode":"NW1 1AB","TownName":"London","Country":"GB"}}]},"Links":{"Self":"https://api.alphabank.com/open-banking/v3.1/aisp/accounts/22289/party"},"Meta":{"TotalPages":1}}
Request
GET
/api/:provider_code/open-banking/v3.1/aisp/accounts/:account_id/party
Headers
Request parameters
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus, TooEarly
string, required
A unique and immutable identifier used to identify the account resource. This identifier has no meaning to the account owner.
Can raise:
ResourceNotFound
Response headers
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
hash, required
Wrapper for the data.
hash, required
Party wrapper.
string, optional
A unique and immutable identifier used to identify the customer resource. This identifier has no meaning to the account owner.
string, optional
Number assigned by an agent to identify its customer.
string, optional
Party type.
string, optional
Name by which a party is known and which is usually used to identify that party.
string, optional
The full legal name of the party.
string, optional
Legal standing of the party.
boolean, optional
A flag to indicate a party's beneficial ownership of the related account.
string, optional
A party's role with respect to the related account.
string, optional
Address for electronic mail (e-mail).
string, optional
Collection of information that identifies a phone number as defined by telecom services.
string, optional
Collection of information that identifies a mobile phone number as defined by telecom services.
hash, optional
The Party's relationships with other resources.
hash, optional
Relationship to the Account resource.
string, required
Absolute URI to the related resource.
string, required
Unique identification as assigned by the PASP to uniquely identify the related resource.
hash, optional
Postal address of a party.
string, optional
Identifies the nature of the postal address.
array, optional
Information that locates and identifies a specific address, as defined by postal services, that is presented in free format text.
string, optional
Name of a street or thoroughfare.
string, optional
Number that identifies the position of a building on a street.
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
string, optional
Name of a built-up area, with defined boundaries, and a local government.
string, optional
Identifies a subdivision of a country eg, state, region, county.
string, required
Nation with its own government, occupying a particular territory. (ISO 3166-1 alpha-2 code)
Can raise:
FieldInvalid, CountryNameInvalid
hash, required
A list of hyperlinks to be recognized by the TPP.
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
hash, optional
Wrapper for the meta.
datetime, optional
Date of the first available transaction All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
datetime, optional
Date of the last available transaction. All dates are represented in ISO 8601 date-time format (e.g. 2020-04-05T10:43:07+00:00).
integer, optional
The total number of pages.
Related Errors
Class |
Code |
Description |
FieldInvalid
|
400 |
An invalid value is supplied in the field. More details in error_message . |
ResourceNotFound
|
400 |
Specified resource doesn't exist. |
ResourceInvalidConsentStatus
|
400 |
The action can't be performed with current status of consent. |
HeaderMissing
|
400 |
A required HTTP header has not been provided. |
HeaderInvalid
|
400 |
An invalid value is supplied in the HTTP header. |
Unauthorized
|
401 |
Unauthorized access. |
Forbidden
|
403 |
Action is forbidden. More details in error_message . |
TooEarly
|
425 |
The service is not ready to process the request. |