openapi: 3.0.0
info:
title: Account and Transaction API Specification
description: Swagger for Account and Transaction API Specification
termsOfService: https://www.openbanking.org.uk/terms
contact:
name: Service Desk
email: ServiceDesk@openbanking.org.uk
license:
name: open-licence
url: https://www.openbanking.org.uk/open-licence
version: 4.0.0
paths:
/account-access-consents:
post:
tags:
- Account Access
summary: Create Account Access Consents
operationId: CreateAccountAccessConsents
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
requestBody:
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadConsent1'
application/json:
schema:
$ref: '#/components/schemas/OBReadConsent1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadConsent1'
description: Default
required: true
responses:
'201':
$ref: '#/components/responses/201AccountAccessConsentsCreated'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'415':
$ref: '#/components/responses/415Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- TPPOAuth2Security:
- accounts
/account-access-consents/{ConsentId}:
get:
tags:
- Account Access
summary: Get Account Access Consents
operationId: GetAccountAccessConsentsConsentId
parameters:
- $ref: '#/components/parameters/ConsentId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountAccessConsentsConsentIdRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- TPPOAuth2Security:
- accounts
delete:
tags:
- Account Access
summary: Delete Account Access Consents
operationId: DeleteAccountAccessConsentsConsentId
parameters:
- $ref: '#/components/parameters/ConsentId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'204':
$ref: '#/components/responses/204AccountAccessConsentsConsentIdDeleted'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- TPPOAuth2Security:
- accounts
/accounts:
get:
tags:
- Accounts
summary: Get Accounts
operationId: GetAccounts
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}:
get:
tags:
- Accounts
summary: Get Accounts
operationId: GetAccountsAccountId
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/balances:
get:
tags:
- Balances
summary: Get Balances
operationId: GetAccountsAccountIdBalances
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdBalancesRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/beneficiaries:
get:
tags:
- Beneficiaries
summary: Get Beneficiaries
operationId: GetAccountsAccountIdBeneficiaries
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdBeneficiariesRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/direct-debits:
get:
tags:
- Direct Debits
summary: Get Direct Debits
operationId: GetAccountsAccountIdDirectDebits
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdDirectDebitsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/offers:
get:
tags:
- Offers
summary: Get Offers
operationId: GetAccountsAccountIdOffers
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdOffersRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/parties:
get:
tags:
- Parties
summary: Get Parties
operationId: GetAccountsAccountIdParties
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdPartiesRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/party:
get:
tags:
- Parties
summary: Get Parties
operationId: GetAccountsAccountIdParty
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdPartyRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/product:
get:
tags:
- Products
summary: Get Products
operationId: GetAccountsAccountIdProduct
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdProductRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/scheduled-payments:
get:
tags:
- Scheduled Payments
summary: Get Scheduled Payments
operationId: GetAccountsAccountIdScheduledPayments
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdScheduledPaymentsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/standing-orders:
get:
tags:
- Standing Orders
summary: Get Standing Orders
operationId: GetAccountsAccountIdStandingOrders
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdStandingOrdersRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/statements:
get:
tags:
- Statements
summary: Get Statements
operationId: GetAccountsAccountIdStatements
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
- $ref: '#/components/parameters/FromStatementDateTimeParam'
- $ref: '#/components/parameters/ToStatementDateTimeParam'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdStatementsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/statements/{StatementId}:
get:
tags:
- Statements
summary: Get Statements
operationId: GetAccountsAccountIdStatementsStatementId
parameters:
- $ref: '#/components/parameters/StatementId'
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdStatementsStatementIdRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/statements/{StatementId}/file:
get:
tags:
- Statements
summary: Get Statements
operationId: GetAccountsAccountIdStatementsStatementIdFile
parameters:
- $ref: '#/components/parameters/StatementId'
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: >-
#/components/responses/200AccountsAccountIdStatementsStatementIdFileRead
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/statements/{StatementId}/transactions:
get:
tags:
- Transactions
summary: Get Transactions
operationId: GetAccountsAccountIdStatementsStatementIdTransactions
parameters:
- $ref: '#/components/parameters/StatementId'
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: >-
#/components/responses/200AccountsAccountIdStatementsStatementIdTransactionsRead
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/accounts/{AccountId}/transactions:
get:
tags:
- Transactions
summary: Get Transactions
operationId: GetAccountsAccountIdTransactions
parameters:
- $ref: '#/components/parameters/AccountId'
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
- $ref: '#/components/parameters/FromBookingDateTimeParam'
- $ref: '#/components/parameters/ToBookingDateTimeParam'
responses:
'200':
$ref: '#/components/responses/200AccountsAccountIdTransactionsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/balances:
get:
tags:
- Balances
summary: Get Balances
operationId: GetBalances
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200BalancesRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/beneficiaries:
get:
tags:
- Beneficiaries
summary: Get Beneficiaries
operationId: GetBeneficiaries
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200BeneficiariesRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/direct-debits:
get:
tags:
- Direct Debits
summary: Get Direct Debits
operationId: GetDirectDebits
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200DirectDebitsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/offers:
get:
tags:
- Offers
summary: Get Offers
operationId: GetOffers
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200OffersRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/party:
get:
tags:
- Parties
summary: Get Parties
operationId: GetParty
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200PartyRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/products:
get:
tags:
- Products
summary: Get Products
operationId: GetProducts
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200ProductsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/scheduled-payments:
get:
tags:
- Scheduled Payments
summary: Get Scheduled Payments
operationId: GetScheduledPayments
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200ScheduledPaymentsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/standing-orders:
get:
tags:
- Standing Orders
summary: Get Standing Orders
operationId: GetStandingOrders
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200StandingOrdersRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/statements:
get:
tags:
- Statements
summary: Get Statements
operationId: GetStatements
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/FromStatementDateTimeParam'
- $ref: '#/components/parameters/ToStatementDateTimeParam'
- $ref: '#/components/parameters/x-customer-user-agent'
responses:
'200':
$ref: '#/components/responses/200StatementsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
/transactions:
get:
tags:
- Transactions
summary: Get Transactions
operationId: GetTransactions
parameters:
- $ref: '#/components/parameters/x-fapi-auth-date'
- $ref: '#/components/parameters/x-fapi-customer-ip-address'
- $ref: '#/components/parameters/x-fapi-interaction-id'
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/x-customer-user-agent'
- $ref: '#/components/parameters/FromBookingDateTimeParam'
- $ref: '#/components/parameters/ToBookingDateTimeParam'
responses:
'200':
$ref: '#/components/responses/200TransactionsRead'
'400':
$ref: '#/components/responses/400Error'
'401':
$ref: '#/components/responses/401Error'
'403':
$ref: '#/components/responses/403Error'
'404':
$ref: '#/components/responses/404Error'
'405':
$ref: '#/components/responses/405Error'
'406':
$ref: '#/components/responses/406Error'
'429':
$ref: '#/components/responses/429Error'
'500':
$ref: '#/components/responses/500Error'
security:
- PSUOAuth2Security:
- accounts
servers:
- url: /open-banking/v4.0/aisp
components:
parameters:
FromBookingDateTimeParam:
in: query
name: fromBookingDateTime
description: >-
The UTC ISO 8601 Date Time to filter transactions FROM
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the ASPSP must ignore the timezone
component.
schema:
type: string
format: date-time
ToBookingDateTimeParam:
in: query
name: toBookingDateTime
description: >-
The UTC ISO 8601 Date Time to filter transactions TO
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the ASPSP must ignore the timezone
component.
schema:
type: string
format: date-time
FromStatementDateTimeParam:
in: query
name: fromStatementDateTime
description: >-
The UTC ISO 8601 Date Time to filter statements FROM
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the ASPSP must ignore the timezone
component.
schema:
type: string
format: date-time
ToStatementDateTimeParam:
in: query
name: toStatementDateTime
description: >-
The UTC ISO 8601 Date Time to filter statements TO
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the ASPSP must ignore the timezone
component.
schema:
type: string
format: date-time
ConsentId:
name: ConsentId
in: path
description: ConsentId
required: true
schema:
type: string
AccountId:
name: AccountId
in: path
description: AccountId
required: true
schema:
type: string
StatementId:
name: StatementId
in: path
description: StatementId
required: true
schema:
type: string
Authorization:
in: header
name: Authorization
required: true
description: An Authorisation Token as per https://tools.ietf.org/html/rfc6750
schema:
type: string
x-customer-user-agent:
in: header
name: x-customer-user-agent
description: Indicates the user-agent that the PSU is using.
required: false
schema:
type: string
x-fapi-customer-ip-address:
in: header
name: x-fapi-customer-ip-address
required: false
description: The PSU's IP address if the PSU is currently logged in with the TPP.
schema:
type: string
x-fapi-auth-date:
in: header
name: x-fapi-auth-date
required: false
description: >-
The time when the PSU last logged in with the TPP.
All dates in the HTTP headers are represented as RFC 7231 Full Dates. An
example is below:
Sun, 10 Sep 2017 19:43:31 UTC
schema:
type: string
pattern: >-
^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2}
(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4}
\d{2}:\d{2}:\d{2} (GMT|UTC)$
x-fapi-interaction-id:
in: header
name: x-fapi-interaction-id
required: false
description: An RFC4122 UID used as a correlation id.
schema:
type: string
x-idempotency-key:
name: x-idempotency-key
in: header
description: |
Every request will be processed only once per x-idempotency-key. The
Idempotency Key will be valid for 24 hours.
required: true
schema:
type: string
maxLength: 40
pattern: ^(?!\s)(.*)(\S)$
x-jws-signature:
in: header
name: x-jws-signature
required: true
description: A detached JWS signature of the body of the payload.
schema:
type: string
responses:
201AccountAccessConsentsCreated:
description: Account Access Consents Created
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadConsentResponse1'
application/json:
schema:
$ref: '#/components/schemas/OBReadConsentResponse1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadConsentResponse1'
200AccountAccessConsentsConsentIdRead:
description: Account Access Consents Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadConsentResponse1'
application/json:
schema:
$ref: '#/components/schemas/OBReadConsentResponse1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadConsentResponse1'
204AccountAccessConsentsConsentIdDeleted:
description: Account Access Consents Deleted
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
200AccountsRead:
description: Accounts Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadAccount6'
application/json:
schema:
$ref: '#/components/schemas/OBReadAccount6'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadAccount6'
200AccountsAccountIdRead:
description: Accounts Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadAccount6'
application/json:
schema:
$ref: '#/components/schemas/OBReadAccount6'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadAccount6'
200AccountsAccountIdBalancesRead:
description: Balances Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadBalance1'
application/json:
schema:
$ref: '#/components/schemas/OBReadBalance1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadBalance1'
200BalancesRead:
description: Balances Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadBalance1'
application/json:
schema:
$ref: '#/components/schemas/OBReadBalance1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadBalance1'
200AccountsAccountIdBeneficiariesRead:
description: Beneficiaries Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadBeneficiary5'
application/json:
schema:
$ref: '#/components/schemas/OBReadBeneficiary5'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadBeneficiary5'
200BeneficiariesRead:
description: Beneficiaries Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadBeneficiary5'
application/json:
schema:
$ref: '#/components/schemas/OBReadBeneficiary5'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadBeneficiary5'
200AccountsAccountIdDirectDebitsRead:
description: Direct Debits Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadDirectDebit2'
application/json:
schema:
$ref: '#/components/schemas/OBReadDirectDebit2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadDirectDebit2'
200DirectDebitsRead:
description: Direct Debits Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadDirectDebit2'
application/json:
schema:
$ref: '#/components/schemas/OBReadDirectDebit2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadDirectDebit2'
200AccountsAccountIdOffersRead:
description: Offers Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadOffer1'
application/json:
schema:
$ref: '#/components/schemas/OBReadOffer1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadOffer1'
200OffersRead:
description: Offers Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadOffer1'
application/json:
schema:
$ref: '#/components/schemas/OBReadOffer1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadOffer1'
200AccountsAccountIdPartiesRead:
description: Parties Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadParty3'
application/json:
schema:
$ref: '#/components/schemas/OBReadParty3'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadParty3'
200AccountsAccountIdPartyRead:
description: Parties Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadParty2'
application/json:
schema:
$ref: '#/components/schemas/OBReadParty2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadParty2'
200PartyRead:
description: Parties Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadParty2'
application/json:
schema:
$ref: '#/components/schemas/OBReadParty2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadParty2'
200AccountsAccountIdProductRead:
description: Products Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadProduct2'
application/json:
schema:
$ref: '#/components/schemas/OBReadProduct2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadProduct2'
200ProductsRead:
description: Products Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadProduct2'
application/json:
schema:
$ref: '#/components/schemas/OBReadProduct2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadProduct2'
200AccountsAccountIdScheduledPaymentsRead:
description: Scheduled Payments Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadScheduledPayment3'
application/json:
schema:
$ref: '#/components/schemas/OBReadScheduledPayment3'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadScheduledPayment3'
200ScheduledPaymentsRead:
description: Scheduled Payments Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadScheduledPayment3'
application/json:
schema:
$ref: '#/components/schemas/OBReadScheduledPayment3'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadScheduledPayment3'
200AccountsAccountIdStandingOrdersRead:
description: Standing Orders Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadStandingOrder6'
application/json:
schema:
$ref: '#/components/schemas/OBReadStandingOrder6'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadStandingOrder6'
200StandingOrdersRead:
description: Standing Orders Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadStandingOrder6'
application/json:
schema:
$ref: '#/components/schemas/OBReadStandingOrder6'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadStandingOrder6'
200AccountsAccountIdStatementsRead:
description: Statements Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadStatement2'
application/json:
schema:
$ref: '#/components/schemas/OBReadStatement2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadStatement2'
200AccountsAccountIdStatementsStatementIdRead:
description: Statements Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadStatement2'
application/json:
schema:
$ref: '#/components/schemas/OBReadStatement2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadStatement2'
200AccountsAccountIdStatementsStatementIdFileRead:
description: Statements Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/File'
application/json:
schema:
$ref: '#/components/schemas/File'
application/jose+jwe:
schema:
$ref: '#/components/schemas/File'
200AccountsAccountIdStatementsStatementIdTransactionsRead:
description: Transactions Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
application/json:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
200StatementsRead:
description: Statements Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadStatement2'
application/json:
schema:
$ref: '#/components/schemas/OBReadStatement2'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadStatement2'
200AccountsAccountIdTransactionsRead:
description: Transactions Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
application/json:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
200TransactionsRead:
description: Transactions Read
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
application/json:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBReadTransaction6'
400Error:
description: Bad request
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
application/json:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
401Error:
description: Unauthorized
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
403Error:
description: Forbidden
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
application/json:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
404Error:
description: Not found
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
405Error:
description: Method Not Allowed
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
406Error:
description: Not Acceptable
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
415Error:
description: Unsupported Media Type
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
429Error:
description: Too Many Requests
headers:
Retry-After:
description: Number in seconds to wait
schema:
type: integer
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
schema:
type: string
500Error:
description: Internal Server Error
headers:
x-fapi-interaction-id:
description: An RFC4122 UID used as a correlation id.
required: true
schema:
type: string
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
application/json:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
application/jose+jwe:
schema:
$ref: '#/components/schemas/OBErrorResponse1'
securitySchemes:
TPPOAuth2Security:
type: oauth2
description: TPP client credential authorisation flow with the ASPSP
flows:
clientCredentials:
tokenUrl: https://authserver.example/token
scopes:
accounts: Ability to read Accounts information
PSUOAuth2Security:
type: oauth2
description: >-
OAuth flow, it is required when the PSU needs to perform SCA with the
ASPSP when a TPP wants to access an ASPSP resource owned by the PSU
flows:
authorizationCode:
authorizationUrl: https://authserver.example/authorization
tokenUrl: https://authserver.example/token
scopes:
accounts: Ability to read Accounts information
schemas:
ExternalCreditorReferenceType1Code:
type: string
minLength: 1
maxLength: 4
description: "Specifies the type of creditor reference as published in an external creditor reference type code set. For more information see `ExternalCreditorReferenceType1Code` in *ISO_External_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)"
enum:
- DISP
- FXDR
- PUOR
- RPIN
- RADM
- SCOR
ExternalDocumentType1Code:
type: string
minLength: 1
maxLength: 4
description: >-
Specifies the document type as published in an external document type
code list. For more information see `ExternalDocumentType1Code` in *ISO_External_CodeSet*
[here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
enum:
- CINV
- CNFA
- CONT
- CREN
- DEBN
- DISP
- DNFA
- HIRI
- INVS
- MSIN
- PROF
- PUOR
- QUOT
- SBIN
- SPRR
- TISH
OBReferredDocumentInformation:
type: object
properties:
Code:
$ref: '#/components/schemas/ExternalDocumentType1Code'
Issuer:
description: 'dentification of the issuer of the reference document type.'
type: string
maxLength: 140
minLength: 1
Number:
description: 'Identification of the type specified for the referred document line.'
type: string
maxLength: 35
minLength: 1
RelatedDate:
description: 'Date associated with the referred document line.'
type: string
format: date-time
LineDetails:
description: 'Set of elements used to provide the content of the referred document line.'
type: array
items:
type: string
OBRemittanceInformation2:
type: object
description: >-
Information supplied to enable the matching of an entry with the items
that the transfer is intended to settle, such as commercial invoices in
an accounts' receivable system
properties:
Structured:
type: array
items:
$ref: '#/components/schemas/OBRemittanceInformationStructured'
Unstructured:
type: array
description: >-
Information supplied to enable the matching/reconciliation of an
entry with the items that the payment is intended to settle, such as
commercial invoices in an accounts' receivable system, in an
unstructured form.
items:
type: string
maxLength: 140
minLength: 1
OBRemittanceInformationStructured:
type: object
properties:
ReferredDocumentInformation:
type: array
items:
$ref: '#/components/schemas/OBReferredDocumentInformation'
ReferredDocumentAmount:
description: 'Provides details on the amounts of the referred document.'
type: integer
format: int32
CreditorReferenceInformation:
description: 'Reference information provided by the creditor to allow the identification of the underlying documents.'
type: object
properties:
Code:
$ref: '#/components/schemas/ExternalCreditorReferenceType1Code'
Issuer:
description: 'Entity that assigns the identification.'
type: string
minLength: 1
maxLength: 35
Reference:
description: 'Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.'
type: string
minLength: 1
maxLength: 35
Invoicer:
$ref: '#/components/schemas/Identification_3'
Invoicee:
$ref: '#/components/schemas/Identification_4'
TaxRemittance:
description: 'Provides remittance information about a payment made for tax-related purposes.'
type: string
maxLength: 140
minLength: 1
AdditionalRemittanceInformation:
description: 'Additional information, in free text form, to complement the structured remittance information.'
type: array
items:
type: string
maxLength: 140
minLength: 1
maxItems: 3
OBUltimateCreditor1:
description: Ultimate party to which an amount of money is due.
type: object
properties:
Name:
description: >-
Name by which a party is known and which is usually used to identify
that party.
type: string
minLength: 1
maxLength: 140
Identification:
description: Identification assigned by an institution.
type: string
minLength: 1
maxLength: 256
LEI:
$ref: '#/components/schemas/LEI'
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
PostalAddress:
$ref: '#/components/schemas/OBPostalAddress7'
OBUltimateDebtor1:
description: Ultimate party that owes an amount of money to the (ultimate) creditor.
type: object
properties:
Name:
description: >-
Name by which a party is known and which is usually used to identify
that party.
type: string
minLength: 1
maxLength: 140
Identification:
description: Identification assigned by an institution.
type: string
minLength: 1
maxLength: 256
LEI:
$ref: '#/components/schemas/LEI'
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
PostalAddress:
$ref: '#/components/schemas/OBPostalAddress7'
OBFrequency6:
description: >-
Regularity with which credit transfer instructions are to be created and
processed
type: object
required:
- Type
properties:
Type:
$ref: '#/components/schemas/OBFrequency6Code'
CountPerPeriod:
description: >-
Number of instructions to be created and processed during the
specified period. Specifies a frequency in terms of a count per
period within a specified frequency type. Note: should not be used
alongside `PointInTime`
type: integer
example: 1
format: int32
PointInTime:
$ref: '#/components/schemas/PointInTime'
PointInTime:
description: >-
Exact2NumericText - Further information on the exact point in time the
event should take place. Specifies a frequency in terms of an exact
point in time or moment within a specified frequency type. Note: should
not be used alongside `CountPerPeriod`.
type: string
example: '00'
maxLength: 2
OBFrequency6Code:
description: 'For a full list of values see `OBFrequency6Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)'
type: string
example: MNTH
enum:
- ADHO
- YEAR
- DAIL
- FRTN
- INDA
- MNTH
- QURT
- MIAN
- WEEK
OBProxy1:
description: >-
Specifies an alternate assumed name for the identification of the
account.
type: object
required:
- Identification
- Code
properties:
Identification:
description: >-
Identification used to indicate the account identification under
another specified name.
type: string
example: '2360549017905188'
minLength: 1
maxLength: 2048
Code:
$ref: '#/components/schemas/ExternalProxyAccountType1Code'
Type:
type: string
description: Type of the proxy identification.
minLength: 1
maxLength: 35
ExternalProxyAccountType1Code:
description: >-
Specifies the external proxy account type code, as published in the
proxy account type external code set.
For more information and a
full list of values see `ExternalProxyAccountType1Code` in *ISO_External_CodeSet*
[here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: TELE
enum:
- TELE
- EMAL
- DNAM
- CINC
- COTX
- COID
- CUST
- DRLC
- EIDN
- EWAL
- PVTX
- LEIC
- MBNO
- NIDN
- CCPT
- SHID
- SOSE
- TOKN
- UBIL
- VIPN
- BIID
AccountId:
description: >-
A unique and immutable identifier used to identify the account resource.
This identifier has no meaning to the account owner.
type: string
example: '22289'
minLength: 1
maxLength: 40
ActiveOrHistoricCurrencyCode_0:
description: >-
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.
type: string
pattern: ^[A-Z]{3,3}$
ActiveOrHistoricCurrencyCode_1:
description: >-
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".
type: string
example: GBP
pattern: ^[A-Z]{3,3}$
AddressLine:
description: >-
Information that locates and identifies a specific address for a
transaction entry, that is presented in free format text.
type: string
minLength: 1
maxLength: 70
BeneficiaryId:
description: >-
A unique and immutable identifier used to identify the beneficiary
resource. This identifier has no meaning to the account owner.
type: string
example: Ben1
minLength: 1
maxLength: 40
BookingDateTime:
description: >-
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. All dates in the
JSON payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
BuildingName:
description: Name of a referenced building.
type: string
minLength: 1
maxLength: 140
BuildingNumber:
description: Number that identifies the position of a building on a street.
type: string
example: '11'
minLength: 1
maxLength: 16
CareOf:
description: >-
The 'care of' address is used whenever sending mail to a person or
organisation who does not actually live or work at the address. They
will receive the mail for the individual.
type: string
example: Jane Smith
minLength: 1
maxLength: 140
CountryCode:
description: Nation with its own government, occupying a particular territory.
type: string
pattern: ^[A-Z]{2,2}$
CountrySubDivision:
description: Identifies a subdivision of a country eg, state, region, county.
type: string
minLength: 1
maxLength: 35
CreationDateTime:
description: >-
Date and time at which the resource was created. All dates in the JSON
payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
example: '2024-05-29T00:00:00Z'
format: date-time
Date:
description: >-
Date and time associated with the date time type. All dates in the JSON
payloads are represented in ISO 8601 date format.
An example is below:
2017-04-05
type: string
format: date
DateTime:
description: >-
Date and time associated with the date time type. All dates in the JSON
payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
example: '2024-05-29T00:00:00Z'
format: date-time
DebtorReference:
description: >-
A reference value provided by the PSU to the PISP while setting up the
scheduled payment.
type: string
example: REF51561806
minLength: 1
maxLength: 35
Description_0:
description: Specifies the description of the account type.
type: string
minLength: 1
maxLength: 35
Description_1:
description: Description that may be available for the statement fee.
type: string
example: International usage charge
minLength: 1
maxLength: 128
Description_2:
description: Description that may be available for the statement interest.
example: Interest occurred over statement duration
type: string
minLength: 1
maxLength: 128
Description_3:
description: Description to describe the purpose of the code
type: string
minLength: 1
maxLength: 350
DirectDebitId:
description: >-
A unique and immutable identifier used to identify the direct debit
resource. This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
DistrictName:
description: >-
Number that of the regional area, known as a district, which forms part
of an address
type: string
example: Greater London
minLength: 1
maxLength: 140
EmailAddress:
description: Address for electronic mail (e-mail).
type: string
example: d.user@semiotec.co.jp
minLength: 1
maxLength: 256
EndDateTime:
description: >-
Date and time at which the statement period ends. All dates in the JSON
payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
example: '2017-07-12T00:00:00+00:00'
format: date-time
File:
type: object
properties: {}
FinalPaymentDateTime:
description: >-
The date on which the final payment for a Standing Order schedule will
be made. All dates in the JSON payloads are represented in ISO 8601
date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
FirstPaymentDateTime:
description: >-
The date on which the first payment for a Standing Order schedule will
be made. All dates in the JSON payloads are represented in ISO 8601
date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Floor:
description: Number that identifies the level within a building
type: string
example: '11'
minLength: 1
maxLength: 70
Frequency_1:
description: >-
Individual Definitions:
NotKnown - Not Known
EvryDay - Every day
EvryWorkgDay - Every working day
IntrvlDay - An interval specified in number of calendar days (02 to 31)
IntrvlWkDay - An interval specified in weeks (01 to 09), and the day
within the week (01 to 07)
WkInMnthDay - A monthly interval, specifying the week of the month (01
to 05) and day within the week (01 to 07)
IntrvlMnthDay - An interval specified in months (between 01 to 06, 12,
24), specifying the day within the month (-05 to -01, 01 to 31)
QtrDay - Quarterly (either ENGLISH, SCOTTISH, or RECEIVED)
ENGLISH = Paid on the 25th March, 24th June, 29th September and 25th
December.
SCOTTISH = Paid on the 2nd February, 15th May, 1st August and 11th
November.
RECEIVED = Paid on the 20th March, 19th June, 24th September and 20th
December.
Individual Patterns:
NotKnown (ScheduleCode)
EvryDay (ScheduleCode)
EvryWorkgDay (ScheduleCode)
IntrvlDay:NoOfDay (ScheduleCode + NoOfDay)
IntrvlWkDay:IntervalInWeeks:DayInWeek (ScheduleCode + IntervalInWeeks +
DayInWeek)
WkInMnthDay:WeekInMonth:DayInWeek (ScheduleCode + WeekInMonth +
DayInWeek)
IntrvlMnthDay:IntervalInMonths:DayInMonth (ScheduleCode +
IntervalInMonths + DayInMonth)
QtrDay: + either (ENGLISH, SCOTTISH or RECEIVED) ScheduleCode +
QuarterDay
The regular expression for this element combines five smaller versions
for each permitted pattern. To aid legibility - the components are
presented individually here:
NotKnown
EvryDay
EvryWorkgDay
IntrvlDay:((0[2-9])|([1-2][0-9])|3[0-1])
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)
Full Regular Expression:
^(NotKnown)$|^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlDay:((0[2-9])|([1-2][0-9])|3[0-1]))$|^(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))$
type: string
pattern: >-
^(NotKnown)$|^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlDay:((0[2-9])|([1-2][0-9])|3[0-1]))$|^(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))$
FullLegalName:
description: The full legal name of the party.
type: string
example: Jane Smith
minLength: 1
maxLength: 350
ISODateTime:
description: >-
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Identification_0:
description: >-
Identification assigned by an institution to identify an account. This
identification is known by the account owner.
type: string
example: '80200112344562'
minLength: 1
maxLength: 256
Identification_1:
description: Unique and unambiguous identification of the servicing institution.
type: string
example: '80200112344562'
minLength: 1
maxLength: 35
Identification_2:
description: >-
Unique and unambiguous identification of a financial institution or a
branch of a financial institution.
type: string
minLength: 1
maxLength: 35
Identification_3:
description: >-
Identification of the organisation issuing the invoice, when it is different from the creditor or ultimate creditor
type: string
example: '80200112344562'
minLength: 1
maxLength: 256
Identification_4:
description: >-
dentification of the party to whom an invoice is issued, when it is different from the debtor or ultimate debtor.
type: string
example: '80200112344562'
minLength: 1
maxLength: 256
LastPaymentDateTime:
description: >-
The date on which the last (most recent) payment for a Standing Order
schedule was made. All dates in the JSON payloads are represented in ISO
8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
example: '2017-07-12T00:00:00+00:00'
format: date-time
LEI:
description: >-
Legal entity identification as an alternate identification for a party.
Legal Entity Identifier is a code allocated to a party as described in
ISO 17442 "Financial Services - Legal Entity Identifier (LEI)".
type: string
example: IZ9Q00LZEVUKWCQY6X15
minLength: 1
maxLength: 20
pattern: ^[A-Z0-9]{18,18}[0-9]{2,2}$
Links:
type: object
description: Links relevant to the payload
properties:
Self:
type: string
format: uri
First:
type: string
format: uri
Prev:
type: string
format: uri
Next:
type: string
format: uri
Last:
type: string
format: uri
additionalProperties: false
required:
- Self
MandateIdentification:
description: >-
Direct Debit reference. For AUDDIS service users provide Core Reference.
For non AUDDIS service users provide Core reference if possible or last
used reference.
type: string
minLength: 1
maxLength: 35
MaturityDate:
description: >-
Maturity date of the account. All dates in the JSON payloads are
represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Meta:
title: MetaData
type: object
description: Meta Data relevant to the payload
properties:
TotalPages:
type: integer
format: int32
FirstAvailableDateTime:
$ref: '#/components/schemas/ISODateTime'
LastAvailableDateTime:
$ref: '#/components/schemas/ISODateTime'
additionalProperties: false
Name_0:
description: >-
The account name is the name or names of the account owner(s)
represented at an account level, as displayed by the ASPSP's online
channels.
Note, the account name is not the product name or the nickname of the
account.
type: string
example: Jane Smith
minLength: 1
maxLength: 350
Name_1:
description: >-
Name by which an agent is known and which is usually used to identify
that agent.
type: string
example: Agent Name
minLength: 1
maxLength: 140
Name_2:
description: Name of Service User.
type: string
minLength: 1
maxLength: 70
Name_3:
description: >-
Name by which a party is known and which is usually used to identify
that party.
type: string
example: Mx Jane Smith
minLength: 1
maxLength: 350
Name_4:
description: Long name associated with the code
type: string
minLength: 1
maxLength: 70
NextPaymentDateTime:
description: >-
The date on which the next payment for a Standing Order schedule will be
made. All dates in the JSON payloads are represented in ISO 8601
date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
example: '2017-07-12T00:00:00+00:00'
format: date-time
Nickname:
description: >-
The nickname of the account, assigned by the account owner in order to
provide an additional means of identification of the account.
type: string
minLength: 1
maxLength: 70
NumberOfPayments:
description: >-
Number of the payments that will be made in completing this frequency
sequence including any executed since the sequence start date.
type: string
minLength: 1
maxLength: 35
Number_0:
description: >-
Indicates whether the advertised overdraft rate is guaranteed to be
offered to a borrower by the bank e.g. if it s part of a government
scheme, or whether the rate may vary dependent on the applicant s
circumstances.
type: integer
Number_1:
description: >-
fee/charges are captured dependent on the number of occurrences rather
than capped at a particular amount
type: integer
OBAccount6:
type: object
description: >-
Unambiguous identification of the account to which credit and debit
entries are made. The following fields are optional only for accounts
that are switched:
* Data.Currency
* Data.AccountCategory
* Data.AccountTypeCode
For all other accounts, the fields must be populated by the ASPSP.
required:
- AccountId
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
Status:
$ref: '#/components/schemas/OBInternalAccountStatus1Code'
StatusUpdateDateTime:
$ref: '#/components/schemas/StatusUpdateDateTime'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_0'
AccountCategory:
$ref: '#/components/schemas/OBInternalAccountType1Code'
AccountTypeCode:
$ref: '#/components/schemas/OBExternalAccountSubType1Code'
Description:
$ref: '#/components/schemas/Description_0'
Nickname:
$ref: '#/components/schemas/Nickname'
OpeningDate:
$ref: '#/components/schemas/OpeningDate'
MaturityDate:
$ref: '#/components/schemas/MaturityDate'
SwitchStatus:
$ref: '#/components/schemas/OBInternalSwitchStatusCode'
Account:
type: array
items:
type: object
description: Provides the details to identify an account.
required:
- SchemeName
- Identification
properties:
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
Identification:
$ref: '#/components/schemas/Identification_0'
Name:
$ref: '#/components/schemas/Name_0'
LEI:
$ref: '#/components/schemas/LEI'
SecondaryIdentification:
$ref: '#/components/schemas/SecondaryIdentification'
StatementFrequencyAndFormat:
$ref: '#/components/schemas/StatementFrequencyAndFormat'
Servicer:
$ref: >-
#/components/schemas/OBBranchAndFinancialInstitutionIdentification5_0
additionalProperties: false
OBAccount6Basic:
type: object
description: >-
Unambiguous identification of the account to which credit and debit
entries are made.
required:
- AccountId
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
Status:
$ref: '#/components/schemas/OBInternalAccountStatus1Code'
StatusUpdateDateTime:
$ref: '#/components/schemas/StatusUpdateDateTime'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_0'
AccountCategory:
$ref: '#/components/schemas/OBInternalAccountType1Code'
AccountTypeCode:
$ref: '#/components/schemas/OBExternalAccountSubType1Code'
Description:
$ref: '#/components/schemas/Description_0'
Nickname:
$ref: '#/components/schemas/Nickname'
OpeningDate:
$ref: '#/components/schemas/OpeningDate'
MaturityDate:
$ref: '#/components/schemas/MaturityDate'
SwitchStatus:
$ref: '#/components/schemas/OBInternalSwitchStatusCode'
additionalProperties: false
OBAccount6Detail:
type: object
description: >-
Unambiguous identification of the account to which credit and debit
entries are made.
required:
- AccountId
- Account
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
Status:
$ref: '#/components/schemas/OBInternalAccountStatus1Code'
StatusUpdateDateTime:
$ref: '#/components/schemas/StatusUpdateDateTime'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_0'
AccountCategory:
$ref: '#/components/schemas/OBInternalAccountType1Code'
AccountTypeCode:
$ref: '#/components/schemas/OBExternalAccountSubType1Code'
Description:
$ref: '#/components/schemas/Description_0'
Nickname:
$ref: '#/components/schemas/Nickname'
OpeningDate:
$ref: '#/components/schemas/OpeningDate'
MaturityDate:
$ref: '#/components/schemas/MaturityDate'
SwitchStatus:
$ref: '#/components/schemas/OBInternalSwitchStatusCode'
Account:
type: array
items:
type: object
description: Provides the details to identify an account.
required:
- SchemeName
- Identification
properties:
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
Identification:
$ref: '#/components/schemas/Identification_0'
Name:
$ref: '#/components/schemas/Name_0'
LEI:
$ref: '#/components/schemas/LEI'
SecondaryIdentification:
$ref: '#/components/schemas/SecondaryIdentification'
StatementFrequencyAndFormat:
$ref: '#/components/schemas/StatementFrequencyAndFormat'
Servicer:
$ref: >-
#/components/schemas/OBBranchAndFinancialInstitutionIdentification5_0
additionalProperties: false
OBInternalAccountStatus1Code:
description: |-
Specifies the status of account resource in code form.
For a full list of enumeration values refer to `OBInternalAccountStatus1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: Enabled
enum:
- Deleted
- Disabled
- Enabled
- Pending
- ProForma
OBActiveCurrencyAndAmount_SimpleType:
description: >-
A number of monetary units specified in an active currency where the
unit of currency is explicit and compliant with ISO 4217.
type: string
example: '1209.06'
pattern: ^\d{1,13}$|^\d{1,13}\.\d{1,5}$
OBActiveOrHistoricCurrencyAndAmount_0:
type: object
required:
- Amount
- Currency
description: The amount of the most recent direct debit collection.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_1:
type: object
required:
- Amount
- Currency
description: >-
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.
Usage: This amount has to be transported unchanged through the
transaction chain.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_10:
type: object
required:
- Amount
- Currency
description: Transaction charges to be paid by the charge bearer.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_11:
type: object
required:
- Amount
- Currency
description: The amount of the last (most recent) Standing Order instruction.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_2:
type: object
required:
- Amount
- Currency
description: The amount of the first Standing Order
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_3:
type: object
required:
- Amount
- Currency
description: The amount of the next Standing Order.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_4:
type: object
required:
- Amount
- Currency
description: The amount of the final Standing Order
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_5:
type: object
required:
- Amount
- Currency
description: Amount of money associated with the statement benefit type.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_6:
type: object
required:
- Amount
- Currency
description: Amount of money associated with the statement fee type.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_7:
type: object
required:
- Amount
- Currency
description: Amount of money associated with the statement interest amount type.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBActiveOrHistoricCurrencyAndAmount_8:
type: object
required:
- Amount
- Currency
description: Amount of money associated with the amount type.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
SubType:
$ref: '#/components/schemas/OBExternalBalanceSubType1Code'
OBActiveOrHistoricCurrencyAndAmount_9:
type: object
required:
- Amount
- Currency
description: Amount of money in the cash transaction entry.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
OBAddressTypeCode:
description: Identifies the nature of the postal address.
type: string
enum:
- Business
- Correspondence
- DeliveryTo
- MailTo
- POBox
- Postal
- Residential
- Statement
OBAddressType2Code:
description: >-
Identifies the nature of the postal address.
For a full set of codes see `OBAddressType2Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets).
type: string
example: BIZZ
enum:
- BIZZ
- DLVY
- MLTO
- PBOX
- ADDR
- HOME
- CORR
- STAT
OBBCAData1:
type: object
title: BCA
properties:
ProductDetails:
type: object
title: ProductDetails
properties:
Segment:
description: >-
Market segmentation is a marketing term referring to the
aggregating of prospective buyers into groups, or segments, that
have common needs and respond similarly to a marketing action.
Market segmentation enables companies to target different
categories of consumers who perceive the full value of certain
products and services differently from one another.
Read more: Market Segmentation
http://www.investopedia.com/terms/m/marketsegmentation.asp#ixzz4gfEEalTd
With respect to BCA products, they are segmented in relation to
different markets that they wish to focus on.
title: Segment
type: array
items:
description: >-
Market segmentation is a marketing term referring to the
aggregating of prospective buyers into groups, or segments,
that have common needs and respond similarly to a marketing
action. Market segmentation enables companies to target
different categories of consumers who perceive the full value
of certain products and services differently from one another.
Read more: Market Segmentation
http://www.investopedia.com/terms/m/marketsegmentation.asp#ixzz4gfEEalTd
With respect to BCA products, they are segmented in relation
to different markets that they wish to focus on.
type: string
enum:
- ClientAccount
- Standard
- NonCommercialChaitiesClbSoc
- NonCommercialPublicAuthGovt
- Religious
- SectorSpecific
- Startup
- Switcher
FeeFreeLength:
description: The length/duration of the fee free period
title: FeeFreeLength
type: number
format: float
FeeFreeLengthPeriod:
description: >-
The unit of period (days, weeks, months etc.) of the promotional
length
title: FeeFreeLengthPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: Optional additional notes to supplement the Core product details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
additionalProperties: false
CreditInterest:
description: >-
Details about the interest that may be payable to the BCA account
holders
type: object
title: CreditInterest
properties:
TierBandSet:
description: >-
The group of tiers or bands for which credit interest can be
applied.
type: array
title: TierBandSet
items:
description: >-
The group of tiers or bands for which credit interest can be
applied.
type: object
properties:
TierBandMethod:
description: >-
The methodology of how credit interest is paid/applied. It
can be:-
1. Banded
Interest rates are banded. i.e. Increasing rate on whole
balance as balance increases.
2. Tiered
Interest rates are tiered. i.e. increasing rate for each
tier as balance increases, but interest paid on tier fixed
for that tier and not on whole balance.
3. Whole
The same interest rate is applied irrespective of the BCA
balance
title: TierBandMethod
type: string
enum:
- Banded
- Tiered
- Whole
CalculationMethod:
description: Methods of calculating interest
title: CalculationMethod
type: string
enum:
- Compound
- SimpleInterest
Destination:
description: >-
Describes whether accrued interest is payable only to the
BCA or to another bank account
title: Destination
type: string
enum:
- PayAway
- SelfCredit
Notes:
description: >-
Optional additional notes to supplement the Tier Band Set
details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
TierBand:
description: Tier Band Details
type: array
title: TierBand
items:
description: Tier Band Details
type: object
properties:
Identification:
description: >-
Unique and unambiguous identification of a Tier
Band for a BCA.
title: Identification
type: string
minLength: 1
maxLength: 35
TierValueMinimum:
description: >-
Minimum deposit value for which the credit interest
tier applies.
title: TierValueMinimum
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMaximum:
description: >-
Maximum deposit value for which the credit interest
tier applies.
title: TierValueMaximum
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CalculationFrequency:
description: >-
How often is credit interest calculated for the
account.
title: CalculationFrequency
type: string
enum:
- Daily
- HalfYearly
- Monthly
- Other
- Quarterly
- PerStatementDate
- Weekly
- Yearly
ApplicationFrequency:
description: >-
How often is interest applied to the BCA for this
tier/band i.e. how often the financial institution
pays accumulated interest to the customer's BCA.
title: ApplicationFrequency
type: string
enum:
- Daily
- HalfYearly
- Monthly
- Other
- Quarterly
- PerStatementDate
- Weekly
- Yearly
DepositInterestAppliedCoverage:
description: Amount on which Interest applied.
title: DepositInterestAppliedCoverage
type: string
enum:
- Banded
- Tiered
- Whole
FixedVariableInterestRateType:
description: Type of interest rate, Fixed or Variable
title: FixedVariableInterestRateType
type: string
enum:
- Fixed
- Variable
AER:
description: >-
The annual equivalent rate (AER) is interest that is
calculated under the assumption that any interest
paid is combined with the original balance and the
next interest payment will be based on the slightly
higher account balance. Overall, this means that
interest can be compounded several times in a year
depending on the number of times that interest
payments are made.
Read more: Annual Equivalent Rate (AER)
http://www.investopedia.com/terms/a/aer.asp#ixzz4gfR7IO1A
title: AER
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
BankInterestRateType:
description: >-
Interest rate types, other than AER, which financial
institutions may use to describe the annual interest
rate payable to the BCA.
title: BankInterestRateType
type: string
enum:
- Gross
- Other
BankInterestRate:
description: Bank Interest for the BCA product
title: BankInterestRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
Notes:
description: >-
Optional additional notes to supplement the Tier
Band details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherBankInterestType:
description: >-
Other interest rate types which are not available in
the standard code list
type: object
title: OtherBankInterestType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file
to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies that are not available
in the standard code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file
to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not available
in the standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file
to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
required:
- TierValueMinimum
- ApplicationFrequency
- FixedVariableInterestRateType
- AER
minItems: 1
required:
- TierBandMethod
- Destination
- TierBand
minItems: 1
additionalProperties: false
required:
- TierBandSet
Overdraft:
description: Borrowing details
type: object
title: Overdraft
properties:
Notes:
description: Associated Notes about the overdraft rates
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftTierBandSet:
description: Tier band set details
type: array
title: OverdraftTierBandSet
items:
description: Tier band set details
type: object
properties:
TierBandMethod:
description: >-
The methodology of how overdraft is charged. It can be:
'Whole' Where the same charge/rate is applied to the
entirety of the overdraft balance (where charges are
applicable).
'Tiered' Where different charges/rates are applied
dependent on overdraft maximum and minimum balance amount
tiers defined by the lending financial organisation
'Banded' Where different charges/rates are applied
dependent on overdraft maximum and minimum balance amount
bands defined by a government organisation.
title: TierBandMethod
type: string
enum:
- Banded
- Tiered
- Whole
OverdraftType:
description: >-
An overdraft can either be 'committed' which means that
the facility cannot be withdrawn without reasonable
notification before it's agreed end date, or 'on demand'
which means that the financial institution can demand
repayment at any point in time.
title: OverdraftType
type: string
enum:
- Committed
- OnDemand
Identification:
description: >-
Unique and unambiguous identification of a Tier Band for
a overdraft product.
title: Identification
type: string
minLength: 1
maxLength: 35
AuthorisedIndicator:
description: >-
Indicates if the Overdraft is authorised (Y) or
unauthorised (N)
title: AuthorisedIndicator
type: boolean
BufferAmount:
description: >-
When a customer exceeds their credit limit, a financial
institution will not charge the customer unauthorised
overdraft charges if they do not exceed by more than the
buffer amount. Note: Authorised overdraft charges may
still apply.
title: BufferAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
Notes:
description: >-
Optional additional notes to supplement the overdraft Tier
Band Set details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftTierBand:
description: Provides overdraft details for a specific tier or band
type: array
title: OverdraftTierBand
items:
description: Provides overdraft details for a specific tier or band
type: object
properties:
Identification:
description: >-
Unique and unambiguous identification of a Tier
Band for a overdraft.
title: Identification
type: string
minLength: 1
maxLength: 35
TierValueMin:
description: Minimum value of Overdraft Tier/Band
title: TierValueMin
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMax:
description: Maximum value of Overdraft Tier/Band
title: TierValueMax
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
EAR:
description: >-
EAR means Effective Annual Rate and/or Equivalent
Annual Rate (frequently
used interchangeably), being the actual annual
interest rate of an Overdraft.
title: EAR
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
RepresentativeAPR:
description: >-
An annual percentage rate (APR) is the annual rate
charged for borrowing or earned through an
investment. APR is expressed as a percentage that
represents the actual yearly cost of funds over the
term of a loan. This includes any fees or additional
costs associated with the transaction but does not
take compounding into account.
title: RepresentativeAPR
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
AgreementLengthMin:
description: >-
Specifies the minimum length of a band for a fixed
overdraft agreement
title: AgreementLengthMin
type: number
format: float
AgreementLengthMax:
description: >-
Specifies the maximum length of a band for a fixed
overdraft agreement
title: AgreementLengthMax
type: number
format: float
AgreementPeriod:
description: >-
Specifies the period of a fixed length overdraft
agreement
title: AgreementPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
OverdraftInterestChargingCoverage:
description: >-
Refers to which interest rate is applied when
interests are tiered. For example, if an overdraft
balance is £2k and the interest tiers are:- 0-£500
0.1%, 500-1000 0.2%, 1000-10000 0.5%, then the
applicable interest rate could either be 0.5% of the
entire balance (since the account balance sits in
the top interest tier) or
(0.1%*500)+(0.2%*500)+(0.5%*1000). In the 1st
situation, we say the interest is applied to the
‘Whole’ of the account balance, and in the 2nd that
it is ‘Tiered’.
title: OverdraftInterestChargingCoverage
type: string
enum:
- Banded
- Tiered
- Whole
BankGuaranteedIndicator:
description: >-
Indicates whether the advertised overdraft rate is
guaranteed to be offered to a borrower by the bank
e.g. if it’s part of a government scheme, or whether
the rate may vary dependent on the applicant’s
circumstances.
title: BankGuaranteedIndicator
type: boolean
Notes:
description: >-
Optional additional notes to supplement the
Tier/band details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftFeesCharges:
description: Overdraft fees and charges
type: array
title: OverdraftFeesCharges
items:
description: Overdraft fees and charges
type: object
properties:
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges) that
apply to a particular fee/charge. Capping can
either be based on an amount (in gbp), an
amount (in items) or a rate.
type: array
title: OverdraftFeeChargeCap
items:
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount (in
gbp), an amount (in items) or a rate.
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- AnnualReview
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
MinMaxType:
description: Min Max type
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
Indicates whether the advertised
overdraft rate is guaranteed to be
offered to a borrower by the bank e.g.
if it’s part of a government scheme, or
whether the rate may vary dependent on
the applicant’s circumstances.
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for
which the fee/charge is capped
title: CappingPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: >-
Notes related to Overdraft fee charge
cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not
available in the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not
available in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
OverdraftFeeChargeDetail:
description: Details about the fees/charges
type: array
title: OverdraftFeeChargeDetail
items:
description: Details about the fees/charges
type: object
properties:
FeeType:
description: Overdraft fee type
title: FeeType
type: string
enum:
- ArrangedOverdraft
- AnnualReview
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
NegotiableIndicator:
description: >-
Indicates whether fee and charges are
negotiable
title: NegotiableIndicator
type: boolean
OverdraftControlIndicator:
description: >-
Indicates if the fee/charge is already
covered by an 'Overdraft Control' fee or
not.
title: OverdraftControlIndicator
type: boolean
IncrementalBorrowingAmount:
description: >-
Every additional tranche of an overdraft
balance to which an overdraft fee is
applied
title: IncrementalBorrowingAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeAmount:
description: >-
Amount charged for an overdraft
fee/charge (where it is charged in terms
of an amount rather than a rate)
title: FeeAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeRate:
description: >-
Rate charged for overdraft fee/charge
(where it is charged in terms of a rate
rather than an amount)
title: FeeRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
FeeRateType:
description: >-
Rate type for overdraft fee/charge
(where it is charged in terms of a rate
rather than an amount)
title: FeeRateType
type: string
enum:
- Gross
- Other
ApplicationFrequency:
description: >-
Frequency at which the overdraft charge
is applied to the account
title: ApplicationFrequency
type: string
enum:
- OnClosing
- OnOpening
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAnniversary
- Other
- PerHundredPounds
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
CalculationFrequency:
description: >-
How often is the overdraft fee/charge
calculated for the account.
title: CalculationFrequency
type: string
enum:
- OnClosing
- OnOpening
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAnniversary
- Other
- PerHundredPounds
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
Notes:
description: >-
Free text for capturing any other info
related to Overdraft Fees Charge Details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount
(in gbp), an amount (in items) or a
rate.
type: array
title: OverdraftFeeChargeCap
items:
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount
(in gbp), an amount (in items) or a
rate.
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- AnnualReview
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
MinMaxType:
description: Min Max type
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
Indicates whether the advertised
overdraft rate is guaranteed to be
offered to a borrower by the bank e.g.
if it’s part of a government scheme, or
whether the rate may vary dependent on
the applicant’s circumstances.
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for
which the fee/charge is capped
title: CappingPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: >-
Notes related to Overdraft fee charge
cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not
available in the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not
available in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
OtherFeeType:
description: >-
Other Fee type which is not available in
the standard code set
type: object
title: OtherFeeType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherFeeRateType:
description: >-
Other fee rate type code which is not
available in the standard code set
type: object
title: OtherFeeRateType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies that are
not available in the standard code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not
available in the standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
required:
- FeeType
- ApplicationFrequency
minItems: 1
required:
- OverdraftFeeChargeDetail
required:
- TierValueMin
minItems: 1
OverdraftFeesCharges:
description: Overdraft fees and charges details
type: array
title: OverdraftFeesCharges
items:
description: Overdraft fees and charges details
type: object
properties:
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges) that apply
to a particular fee/charge. Capping can either be
based on an amount (in gbp), an amount (in items) or
a rate.
type: array
title: OverdraftFeeChargeCap
items:
description: >-
Details about any caps (maximum charges) that
apply to a particular fee/charge. Capping can
either be based on an amount (in gbp), an amount
(in items) or a rate.
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- AnnualReview
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
MinMaxType:
description: Min Max type
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
Indicates whether the advertised overdraft
rate is guaranteed to be offered to a borrower
by the bank e.g. if it’s part of a government
scheme, or whether the rate may vary dependent
on the applicant’s circumstances.
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for which
the fee/charge is capped
title: CappingPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: Notes related to Overdraft fee charge cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not available in
the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not available
in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
OverdraftFeeChargeDetail:
description: Details about the fees/charges
type: array
title: OverdraftFeeChargeDetail
items:
description: Details about the fees/charges
type: object
properties:
FeeType:
description: Overdraft fee type
title: FeeType
type: string
enum:
- ArrangedOverdraft
- AnnualReview
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
NegotiableIndicator:
description: >-
Indicates whether fee and charges are
negotiable
title: NegotiableIndicator
type: boolean
OverdraftControlIndicator:
description: >-
Indicates if the fee/charge is already covered
by an 'Overdraft Control' fee or not.
title: OverdraftControlIndicator
type: boolean
IncrementalBorrowingAmount:
description: >-
Every additional tranche of an overdraft
balance to which an overdraft fee is applied
title: IncrementalBorrowingAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeAmount:
description: >-
Amount charged for an overdraft fee/charge
(where it is charged in terms of an amount
rather than a rate)
title: FeeAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeRate:
description: >-
Rate charged for overdraft fee/charge (where
it is charged in terms of a rate rather than
an amount)
title: FeeRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
FeeRateType:
description: >-
Rate type for overdraft fee/charge (where it
is charged in terms of a rate rather than an
amount)
title: FeeRateType
type: string
enum:
- Gross
- Other
ApplicationFrequency:
description: >-
Frequency at which the overdraft charge is
applied to the account
title: ApplicationFrequency
type: string
enum:
- OnClosing
- OnOpening
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAnniversary
- Other
- PerHundredPounds
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
CalculationFrequency:
description: >-
How often is the overdraft fee/charge
calculated for the account.
title: CalculationFrequency
type: string
enum:
- OnClosing
- OnOpening
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAnniversary
- Other
- PerHundredPounds
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
Notes:
description: >-
Free text for capturing any other info related
to Overdraft Fees Charge Details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges) that
apply to a particular fee/charge. Capping can
either be based on an amount (in gbp), an
amount (in items) or a rate.
type: array
title: OverdraftFeeChargeCap
items:
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount (in
gbp), an amount (in items) or a rate.
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- AnnualReview
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
MinMaxType:
description: Min Max type
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
Indicates whether the advertised
overdraft rate is guaranteed to be
offered to a borrower by the bank e.g.
if it’s part of a government scheme, or
whether the rate may vary dependent on
the applicant’s circumstances.
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for
which the fee/charge is capped
title: CappingPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: >-
Notes related to Overdraft fee charge
cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not
available in the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not
available in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
OtherFeeType:
description: >-
Other Fee type which is not available in the
standard code set
type: object
title: OtherFeeType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherFeeRateType:
description: >-
Other fee rate type code which is not
available in the standard code set
type: object
title: OtherFeeRateType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies that are not
available in the standard code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not
available in the standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
required:
- FeeType
- ApplicationFrequency
minItems: 1
required:
- OverdraftFeeChargeDetail
required:
- TierBandMethod
- OverdraftTierBand
minItems: 1
additionalProperties: false
required:
- OverdraftTierBandSet
OtherFeesCharges:
description: >-
Contains details of fees and charges which are not associated with
either Overdraft or features/benefits
type: array
title: OtherFeesCharges
items:
description: >-
Contains details of fees and charges which are not associated with
either Overdraft or features/benefits
type: object
properties:
TariffType:
description: TariffType which defines the fee and charges.
title: TariffType
type: string
enum:
- Electronic
- Mixed
- Other
TariffName:
description: Name of the tariff
title: TariffName
type: string
minLength: 1
maxLength: 350
OtherTariffType:
description: Other tariff type which is not in the standard list.
type: object
title: OtherTariffType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
FeeChargeDetail:
description: Other fees/charges details
type: array
title: FeeChargeDetail
items:
description: Other fees/charges details
type: object
properties:
FeeCategory:
description: >-
Categorisation of fees and charges into standard
categories.
title: FeeCategory
type: string
enum:
- Other
- Servicing
FeeType:
description: Fee/Charge Type
title: FeeType
type: string
enum:
- Other
- ServiceCAccountFee
- ServiceCAccountFeeMonthly
- ServiceCAccountFeeQuarterly
- ServiceCFixedTariff
- ServiceCBusiDepAccBreakage
- ServiceCMinimumMonthlyFee
- ServiceCOther
NegotiableIndicator:
description: >-
Fee/charge which is usually negotiable rather than a
fixed amount
title: NegotiableIndicator
type: boolean
FeeAmount:
description: >-
Fee Amount charged for a fee/charge (where it is charged
in terms of an amount rather than a rate)
title: FeeAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeRate:
description: >-
Rate charged for Fee/Charge (where it is charged in
terms of a rate rather than an amount)
title: FeeRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
FeeRateType:
description: >-
Rate type for Fee/Charge (where it is charged in terms
of a rate rather than an amount)
title: FeeRateType
type: string
enum:
- Gross
- Other
ApplicationFrequency:
description: How frequently the fee/charge is applied to the account
title: ApplicationFrequency
type: string
enum:
- OnClosing
- OnOpening
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAnniversary
- Other
- PerHundredPounds
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
CalculationFrequency:
description: How frequently the fee/charge is calculated
title: CalculationFrequency
type: string
enum:
- OnClosing
- OnOpening
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAnniversary
- Other
- PerHundredPounds
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
Notes:
description: >-
Optional additional notes to supplement the fee/charge
details.
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
FeeChargeCap:
description: >-
Details about any caps (maximum charges) that apply to a
particular or group of fee/charge
type: array
title: FeeChargeCap
items:
description: >-
Details about any caps (maximum charges) that apply to
a particular or group of fee/charge
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- Other
- ServiceCAccountFee
- ServiceCAccountFeeMonthly
- ServiceCAccountFeeQuarterly
- ServiceCFixedTariff
- ServiceCBusiDepAccBreakage
- ServiceCMinimumMonthlyFee
- ServiceCOther
minItems: 1
MinMaxType:
description: Min Max type
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on the number
of occurrences rather than capped at a particular
amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: >-
Cap amount charged for a fee/charge (where it is
charged in terms of an amount rather than a rate)
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for which the
fee/charge is capped
title: CappingPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: >-
Free text for adding extra details for fee charge
cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not available in the
standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not available in
the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an XML
file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
OtherFeeCategoryType:
type: object
title: OtherFeeCategoryType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherFeeType:
description: >-
Other Fee/charge type which is not available in the
standard code set
type: object
title: OtherFeeType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
FeeCategory:
description: >-
Categorisation of fees and charges into standard
categories.
title: FeeCategory
type: string
enum:
- Other
- Servicing
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- FeeCategory
- Name
- Description
OtherFeeRateType:
description: >-
Other fee rate type which is not available in the
standard code set
type: object
title: OtherFeeRateType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies not covered in the
standard code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not available in
standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
FeeApplicableRange:
description: >-
Range or amounts or rates for which the fee/charge
applies
type: object
title: FeeApplicableRange
properties:
MinimumAmount:
description: >-
Minimum Amount on which fee/charge is applicable
(where it is expressed as an amount)
title: MinimumAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
MaximumAmount:
description: >-
Maximum Amount on which fee is applicable (where it
is expressed as an amount)
title: MaximumAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
MinimumRate:
description: >-
Minimum rate on which fee/charge is applicable(where
it is expressed as an rate)
title: MinimumRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
MaximumRate:
description: >-
Maximum rate on which fee/charge is applicable(where
it is expressed as an rate)
title: MaximumRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
additionalProperties: false
required:
- FeeCategory
- FeeType
- ApplicationFrequency
minItems: 1
FeeChargeCap:
description: >-
Details about any caps (maximum charges) that apply to a
particular or group of fee/charge
type: array
title: FeeChargeCap
items:
description: >-
Details about any caps (maximum charges) that apply to a
particular or group of fee/charge
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- Other
- ServiceCAccountFee
- ServiceCAccountFeeMonthly
- ServiceCAccountFeeQuarterly
- ServiceCFixedTariff
- ServiceCBusiDepAccBreakage
- ServiceCMinimumMonthlyFee
- ServiceCOther
minItems: 1
MinMaxType:
description: Min Max type
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on the number of
occurrences rather than capped at a particular amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: >-
Cap amount charged for a fee/charge (where it is charged
in terms of an amount rather than a rate)
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for which the
fee/charge is capped
title: CappingPeriod
type: string
enum:
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: Free text for adding extra details for fee charge cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not available in the
standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not available in the
standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file
to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
required:
- FeeChargeDetail
additionalProperties: false
OBBalanceType1Code:
description: >-
Balance type, in a coded form.
For a full list of enumeration values refer to `ExternalBalanceType1Code` in *ISO_External_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets).
type: string
example: CLAV
enum:
- CLAV
- CLBD
- FWAV
- INFO
- ITAV
- ITBD
- OPAV
- OPBD
- PRCD
- XPCD
OBBankTransactionCodeStructure1:
type: object
required:
- Code
- SubCode
description: >-
Set of elements used to fully identify the type of underlying
transaction resulting in an entry.
properties:
Code:
description: Specifies the family within a domain.
type: string
SubCode:
description: Specifies the sub-product family within a specific family.
type: string
OBBeneficiary5:
type: object
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
BeneficiaryId:
$ref: '#/components/schemas/BeneficiaryId'
BeneficiaryType:
$ref: '#/components/schemas/OBInternalBeneficiaryType1Code'
Reference:
$ref: '#/components/schemas/Reference'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
CreditorAgent:
$ref: >-
#/components/schemas/OBBranchAndFinancialInstitutionIdentification6_0
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount5_0'
additionalProperties: false
OBBeneficiary5Basic:
type: object
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
BeneficiaryId:
$ref: '#/components/schemas/BeneficiaryId'
BeneficiaryType:
$ref: '#/components/schemas/OBInternalBeneficiaryType1Code'
Reference:
$ref: '#/components/schemas/Reference'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
additionalProperties: false
OBBeneficiary5Detail:
type: object
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
BeneficiaryId:
$ref: '#/components/schemas/BeneficiaryId'
BeneficiaryType:
$ref: '#/components/schemas/OBInternalBeneficiaryType1Code'
Reference:
$ref: '#/components/schemas/Reference'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
CreditorAgent:
$ref: >-
#/components/schemas/OBBranchAndFinancialInstitutionIdentification6_0
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount5_0'
additionalProperties: false
required:
- CreditorAccount
OBBranchAndFinancialInstitutionIdentification5_0:
type: object
required:
- SchemeName
- Identification
description: >-
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.
properties:
SchemeName:
$ref: >-
#/components/schemas/OBInternalFinancialInstitutionIdentification4Code
Identification:
$ref: '#/components/schemas/Identification_1'
Name:
$ref: '#/components/schemas/Name_1'
OBBranchAndFinancialInstitutionIdentification5_1:
type: object
required:
- SchemeName
- Identification
description: >-
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.
properties:
SchemeName:
$ref: >-
#/components/schemas/OBInternalFinancialInstitutionIdentification4Code
Identification:
$ref: '#/components/schemas/Identification_1'
Name:
$ref: '#/components/schemas/Name_1'
PostalAddress:
$ref: '#/components/schemas/OBPostalAddress7'
LEI:
$ref: '#/components/schemas/LEI'
OBBranchAndFinancialInstitutionIdentification6_0:
type: object
description: >-
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.
properties:
SchemeName:
$ref: >-
#/components/schemas/OBInternalFinancialInstitutionIdentification4Code
Identification:
$ref: '#/components/schemas/Identification_1'
Name:
$ref: '#/components/schemas/Name_1'
PostalAddress:
$ref: '#/components/schemas/OBPostalAddress7'
LEI:
$ref: '#/components/schemas/LEI'
OBBranchAndFinancialInstitutionIdentification6_1:
type: object
description: Financial institution servicing an account for the creditor.
properties:
SchemeName:
$ref: >-
#/components/schemas/OBInternalFinancialInstitutionIdentification4Code
Identification:
$ref: '#/components/schemas/Identification_2'
Name:
$ref: '#/components/schemas/Name_1'
LEI:
$ref: '#/components/schemas/LEI'
PostalAddress:
$ref: '#/components/schemas/OBPostalAddress7'
OBBranchAndFinancialInstitutionIdentification6_2:
type: object
description: Financial institution servicing an account for the debtor.
properties:
SchemeName:
$ref: >-
#/components/schemas/OBInternalFinancialInstitutionIdentification4Code
Identification:
$ref: '#/components/schemas/Identification_2'
Name:
$ref: '#/components/schemas/Name_1'
LEI:
$ref: '#/components/schemas/LEI'
PostalAddress:
$ref: '#/components/schemas/OBPostalAddress7'
OBCashAccount5_0:
type: object
required:
- SchemeName
- Identification
description: Provides the details to identify the beneficiary account.
properties:
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
Identification:
$ref: '#/components/schemas/Identification_0'
Name:
$ref: '#/components/schemas/Name_0'
SecondaryIdentification:
$ref: '#/components/schemas/SecondaryIdentification'
Proxy:
$ref: '#/components/schemas/OBProxy1'
OBCashAccount5_1:
type: object
required:
- SchemeName
- Identification
description: Provides the details to identify the beneficiary account.
properties:
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
Identification:
description: Beneficiary account identification.
type: string
minLength: 1
maxLength: 256
Name:
$ref: '#/components/schemas/Name_0'
SecondaryIdentification:
$ref: '#/components/schemas/SecondaryIdentification'
Proxy:
$ref: '#/components/schemas/OBProxy1'
OBCashAccount6_0:
type: object
description: >-
Unambiguous identification of the account of the creditor, in the case
of a debit transaction.
properties:
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
Identification:
$ref: '#/components/schemas/Identification_0'
Name:
$ref: '#/components/schemas/Name_0'
SecondaryIdentification:
$ref: '#/components/schemas/SecondaryIdentification'
Proxy:
$ref: '#/components/schemas/OBProxy1'
OBCashAccount6_1:
type: object
description: >-
Unambiguous identification of the account of the debtor, in the case of
a crebit transaction.
properties:
SchemeName:
$ref: '#/components/schemas/OBInternalAccountIdentification4Code'
Identification:
$ref: '#/components/schemas/Identification_0'
Name:
$ref: '#/components/schemas/Name_0'
SecondaryIdentification:
$ref: '#/components/schemas/SecondaryIdentification'
Proxy:
$ref: '#/components/schemas/OBProxy1'
ExternalCategoryPurpose1Code:
description: >-
Enumeration of codes that outlines the type of purpose behind a
transaction, payment or risk.
For all enum values see `ExternalCategoryPurpose1Code` in *ISO_External_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- BONU
- CASH
- CBLK
- CCRD
- CGWV
- CIPC
- CONC
- CORT
- DCRD
- DIVI
- DVPM
- EPAY
- FCDT
- FCIN
- FCOL
- GOVT
- GP2P
- HEDG
- ICCP
- IDCP
- INTC
- INTE
- LBOX
- LOAN
- MP2B
- MP2P
- OTHR
- PENS
- RPRE
- RRCT
- RVPM
- SALA
- SECU
- SSBE
- SUPP
- SWEP
- TAXS
- TOPG
- TRAD
- TREA
- VATX
- VOST
- WHLD
- ZABA
OBExternalMandateClassification1Code:
description: Type of mandate instruction. For a full list of values see `OBExternalClassification1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: FIXE
enum:
- FIXE
- USGB
- VARI
OBCommunicationMethod:
description: >-
For a full list of enumeration values see `OBExternalCommunicationMethod2Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_internal_CodeSets)
type: string
enum:
- EMAL
- FAXI
- FILE
- ONLI
- POST
OBCreditDebitCode_0:
description: |-
Indicates whether the amount is a credit or a debit. For a full list of values see `OBInternalCreditDebitCode` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
Usage: A zero amount is considered to be a credit amount.
type: string
example: Credit
enum:
- Credit
- Debit
OBCreditDebitCode_1:
description: |-
Indicates whether the transaction is a credit or a debit entry.
For a full list of enumeration values refer to `OBInternalCreditDebitCode` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- Credit
- Debit
OBCreditDebitCode_2:
description: |-
Indicates whether the balance is a credit or a debit balance.
Usage: A zero balance is considered to be a credit balance.
For a full list of enumeration values refer to `OBInternalCreditDebitCode` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: Credit
enum:
- Credit
- Debit
OBCurrencyExchange5:
type: object
required:
- SourceCurrency
- ExchangeRate
description: Set of elements used to provide details on the currency exchange.
properties:
SourceCurrency:
description: >-
Currency from which an amount is to be converted in a currency
conversion.
type: string
pattern: ^[A-Z]{3,3}$
TargetCurrency:
description: >-
Currency into which an amount is to be converted in a currency
conversion.
type: string
pattern: ^[A-Z]{3,3}$
UnitCurrency:
description: >-
Currency in which the rate of exchange is expressed in a currency
exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
type: string
pattern: ^[A-Z]{3,3}$
ExchangeRate:
description: >-
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).
type: number
ContractIdentification:
description: >-
Unique identification to unambiguously identify the foreign exchange
contract.
type: string
minLength: 1
maxLength: 35
QuotationDate:
description: >-
Date and time at which an exchange rate is quoted. All dates in the
JSON payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
InstructedAmount:
type: object
required:
- Amount
- Currency
description: >-
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.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
ExternalEntryStatus1Code:
description: |-
Status of a transaction entry on the books of the account servicer.
For a full list of enumeration values refer to `ExternalEntryStatus1Code` in *ISO_External_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- BOOK
- FUTR
- INFO
- PDNG
OBInternalTransactionMutability1Code:
description: |-
Specifies the Mutability of the Transaction record.
For a full list of enumeration values refer to `OBInternalTransactionMutability1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- Mutable
- Immutable
OBError1:
type: object
properties:
ErrorCode:
$ref: '#/components/schemas/OBExternalStatusReason1Code'
Message:
description: >-
A description of the error that occurred. e.g., 'A mandatory field
isn't supplied' or 'RequestedExecutionDateTime must be in future'
OBL doesn't standardise this field
type: string
minLength: 1
maxLength: 500
Path:
description: >-
Recommended but optional reference to the JSON Path of the field
with error, e.g., Data.Initiation.InstructedAmount.Currency
type: string
minLength: 1
maxLength: 500
Url:
description: >-
URL to help remediate the problem, or provide more information, or
to API Reference, or help etc
type: string
required:
- ErrorCode
additionalProperties: false
minProperties: 1
OBErrorResponse1:
description: >-
An array of detail error codes, and messages, and URLs to documentation
to help remediation.
type: object
properties:
Id:
description: >-
A unique reference for the error instance, for audit purposes, in
case of unknown/unclassified errors.
type: string
minLength: 1
maxLength: 40
Code:
description: >-
Deprecated
High level textual error code, to help categorise the
errors.
type: string
minLength: 1
example: 400 BadRequest
maxLength: 40
Message:
description: Deprecated
Brief Error message
type: string
minLength: 1
example: There is something wrong with the request parameters provided
maxLength: 500
Errors:
items:
$ref: '#/components/schemas/OBError1'
type: array
minItems: 1
required:
- Errors
additionalProperties: false
OBInternalAccountIdentification4Code:
description: >-
Name of the identification scheme, in a coded form as published in an
external list.
For a full list of enumeration values refer to `OBInternalAccountIdentification4Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
x-namespaced-enum:
- UK.OBIE.BBAN
- UK.OBIE.IBAN
- UK.OBIE.PAN
- UK.OBIE.Paym
- UK.OBIE.SortCodeAccountNumber
- UK.OBIE.Wallet
OBInternalAccountRole1Code:
description: A party’s role with respect to the related account. For a full list refer to `OBInternalAccountRole1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
x-namespaced-enum:
- UK.OBIE.Administrator
- UK.OBIE.Beneficiary
- UK.OBIE.CustodianForMinor
- UK.OBIE.Granter
- UK.OBIE.LegalGuardian
- UK.OBIE.OtherParty
- UK.OBIE.PowerOfAttorney
- UK.OBIE.Principal
- UK.OBIE.Protector
- UK.OBIE.RegisteredShareholderName
- UK.OBIE.SecondaryOwner
- UK.OBIE.SeniorManagingOfficial
- UK.OBIE.Settlor
- UK.OBIE.SuccessorOnDeath
OBExternalAccountSubType1Code:
description: >-
Specifies the sub type of account (product family group)
For a full list of enumeration values refer to `OBExternalCashAccountType1Code` *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- CACC
- CARD
- CASH
- CHAR
- CISH
- COMM
- CPAC
- LLSV
- LOAN
- MGLD
- MOMA
- NREX
- ODFT
- ONDP
- OTHR
- SACC
- SLRY
- SVGS
- TAXE
- TRAN
- TRAS
- VACC
- NFCA
- MORT
- WALT
OBInternalAccountType1Code:
description: >-
Specifies the type of account (personal or business).
For a full list of enumeration values refer to 'OBInternalAccountType1Code' in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- Business
- Personal
OBExternalBalanceSubType1Code:
description: Amount sub type, in a coded form. Default if not specified is BCUR of the account.
type: string
enum:
- BCUR
- LCUR
OBInternalFinancialInstitutionIdentification4Code:
description: >-
Name of the identification scheme, in a coded form as published in an
external list.
For a full list of enumeration values refer to `OBInternalFinancialInstitutionIdentification4Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.BICFI
x-namespaced-enum:
- UK.OBIE.BICFI
OBInternalSwitchStatusCode:
description: >-
Specifies the switch status for the account, in a coded form.
For a full list of enumeration values refer to `OBInternalSwitchStatusCode` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
x-namespaced-enum:
- UK.CASS.NotSwitched
- UK.CASS.SwitchCompleted
OBInternalLegalStructureType1Code:
description: Legal standing of the party. For a full list refer to `OBInternalLegalStructureType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.Individual
x-namespaced-enum:
- UK.OBIE.CIC
- UK.OBIE.CIO
- UK.OBIE.Charity
- UK.OBIE.CoOp
- UK.OBIE.GeneralPartnership
- UK.OBIE.Individual
- UK.OBIE.LimitedLiabilityPartnership
- UK.OBIE.LimitedPartnership
- UK.OBIE.PrivateLimitedCompany
- UK.OBIE.PublicLimitedCompany
- UK.OBIE.ScottishLimitedPartnership
- UK.OBIE.Sole
OBInternalPartyType1Code:
description: Party type, in a coded form. For a full list see `OBInternalPartyType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: Joint
enum:
- Delegate
- Joint
- Sole
OBExternalPurpose1Code:
type: string
minLength: 1
maxLength: 4
description: >-
For a full list of enumeration values refer to `ExternalPurpose1Code` in *ISO_External_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
enum:
- BKDF
- BKFE
- BKFM
- BKIP
- BKPP
- CBLK
- CDCB
- CDCD
- CDCS
- CDDP
- CDOC
- CDQC
- ETUP
- FCOL
- MTUP
- ACCT
- CASH
- COLL
- CSDB
- DEPT
- INTC
- INTP
- LIMA
- NETT
- BFWD
- CCIR
- CCPC
- CCPM
- CCSM
- CRDS
- CRPR
- CRSP
- CRTL
- EQPT
- EQUS
- EXPT
- EXTD
- FIXI
- FWBC
- FWCC
- FWSB
- FWSC
- MARG
- MBSB
- MBSC
- MGCC
- MGSC
- OCCC
- OPBC
- OPCC
- OPSB
- OPSC
- OPTN
- OTCD
- REPO
- RPBC
- RPCC
- RPSB
- RPSC
- RVPO
- SBSC
- SCIE
- SCIR
- SCRP
- SHBC
- SHCC
- SHSL
- SLEB
- SLOA
- SWBC
- SWCC
- SWPT
- SWSB
- SWSC
- TBAS
- TBBC
- TBCC
- TRCP
- AGRT
- AREN
- BEXP
- BOCE
- COMC
- CPYR
- GDDS
- GDSV
- GSCB
- LICF
- MP2B
- POPE
- ROYA
- SCVE
- SERV
- SUBS
- SUPP
- TRAD
- CHAR
- COMT
- MP2P
- ECPG
- ECPR
- ECPU
- EPAY
- CLPR
- COMP
- DBTC
- GOVI
- HLRP
- HLST
- INPC
- INPR
- INSC
- INSU
- INTE
- LBRI
- LIFI
- LOAN
- LOAR
- PENO
- PPTI
- RELG
- RINP
- TRFD
- FORW
- FXNT
- ADMG
- ADVA
- BCDM
- BCFG
- BLDM
- BNET
- CBFF
- CBFR
- CCRD
- CDBL
- CFEE
- CGDD
- CORT
- COST
- CPKC
- DCRD
- DSMT
- DVPM
- EDUC
- FACT
- FAND
- FCPM
- FEES
- GIFT
- GOVT
- ICCP
- IDCP
- IHRP
- INSM
- IVPT
- MCDM
- MCFG
- MSVC
- NOWS
- OCDM
- OCFG
- OFEE
- OTHR
- PADD
- PTSP
- RCKE
- RCPT
- REBT
- REFU
- RENT
- REOD
- RIMB
- RPNT
- RRBN
- RRCT
- RRTP
- RVPM
- SLPI
- SPLT
- STDY
- TBAN
- TBIL
- TCSC
- TELI
- TMPG
- TPRI
- TPRP
- TRNC
- TRVC
- WEBI
- IPAY
- IPCA
- IPDO
- IPEA
- IPEC
- IPEW
- IPPS
- IPRT
- IPU2
- IPUW
- ANNI
- CAFI
- CFDI
- CMDT
- DERI
- DIVD
- FREX
- HEDG
- INVS
- PRME
- SAVG
- SECU
- SEPI
- TREA
- UNIT
- FNET
- FUTR
- ANTS
- CVCF
- DMEQ
- DNTS
- HLTC
- HLTI
- HSPC
- ICRF
- LTCF
- MAFC
- MARF
- MDCS
- VIEW
- CDEP
- SWFP
- SWPP
- SWRS
- SWUF
- ADCS
- AEMP
- ALLW
- ALMY
- BBSC
- BECH
- BENE
- BONU
- CCHD
- COMM
- CSLP
- GFRP
- GVEA
- GVEB
- GVEC
- GVED
- GWLT
- HREC
- PAYR
- PEFC
- PENS
- PRCP
- RHBS
- SALA
- SPSP
- SSBE
- LBIN
- LCOL
- LFEE
- LMEQ
- LMFI
- LMRK
- LREB
- LREV
- LSFL
- ESTX
- FWLV
- GSTX
- HSTX
- INTX
- NITX
- PTXP
- RDTX
- TAXS
- VATX
- WHLD
- TAXR
- B112
- BR12
- TLRF
- TLRR
- AIRB
- BUSB
- FERB
- RLWY
- TRPT
- CBTV
- ELEC
- ENRG
- GASB
- NWCH
- NWCM
- OTLC
- PHON
- UBIL
- WTER
- BOND
- CABD
- CAEQ
- CBCR
- DBCR
- DICL
- EQTS
- FLCR
- EFTC
- EFTD
- MOMA
- RAPI
- GAMB
- LOTT
- AMEX
- SASW
- AUCO
- PCOM
- PDEP
- PLDS
- PLRF
- GAFA
- GAHO
- CPEN
- DEPD
- RETL
- DEBT
OBInternalScheduleType1Code:
description: Specifies the scheduled payment date type requested. For a full list of enumeration values refer to `OBInternalScheduleType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: Arrival
enum:
- Arrival
- Execution
ExternalMandateStatus1Code:
description: >-
Specifies the status of the standing order in code form. For a full
list of enumeration values refer to 'ExternalMandateStatus1Code' in *ISO_External_Codeset* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- ACTV
- CANC
- EXPI
- SUSP
example: ACTV
OBInternalStatementAmountType1Code:
description: Amount type, in a coded form.
type: string
example: UK.OBIE.CreditLimit
x-namespaced-enum:
- UK.OBIE.ArrearsClosingBalance
- UK.OBIE.AvailableBalance
- UK.OBIE.AverageBalanceWhenInCredit
- UK.OBIE.AverageBalanceWhenInDebit
- UK.OBIE.AverageDailyBalance
- UK.OBIE.BalanceTransferClosingBalance
- UK.OBIE.CashClosingBalance
- UK.OBIE.ClosingBalance
- UK.OBIE.CreditLimit
- UK.OBIE.CurrentPayment
- UK.OBIE.DirectDebitPaymentDue
- UK.OBIE.FSCSInsurance
- UK.OBIE.MinimumPaymentDue
- UK.OBIE.PendingTransactionsBalance
- UK.OBIE.PreviousClosingBalance
- UK.OBIE.PreviousPayment
- UK.OBIE.PurchaseClosingBalance
- UK.OBIE.StartingBalance
- UK.OBIE.TotalAdjustments
- UK.OBIE.TotalCashAdvances
- UK.OBIE.TotalCharges
- UK.OBIE.TotalCredits
- UK.OBIE.TotalDebits
- UK.OBIE.TotalPurchases
OBInternalStatementBenefitType1Code:
description: Benefit type, in a coded form. For a full list of values see `OBInternalStatementBenefitType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.Cashback
x-namespaced-enum:
- UK.OBIE.Cashback
- UK.OBIE.Insurance
- UK.OBIE.TravelDiscount
- UK.OBIE.TravelInsurance
OBInternalStatementDateTimeType1Code:
description: Date time type, in a coded form. For a full list of values see `OBInternalStatementDateTimeType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.NextStatement
x-namespaced-enum:
- UK.OBIE.BalanceTransferPromoEnd
- UK.OBIE.DirectDebitDue
- UK.OBIE.LastPayment
- UK.OBIE.LastStatement
- UK.OBIE.NextStatement
- UK.OBIE.PaymentDue
- UK.OBIE.PurchasePromoEnd
- UK.OBIE.StatementAvailable
OBInternalStatementFeeFrequency1Code:
description: How frequently the fee is applied to the Account. For a full list of values see `OBInternalStatementFeeFrequency1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.StatementMonthly
x-namespaced-enum:
- UK.OBIE.ChargingPeriod
- UK.OBIE.PerTransactionAmount
- UK.OBIE.PerTransactionPercentage
- UK.OBIE.Quarterly
- UK.OBIE.StatementMonthly
- UK.OBIE.Weekly
OBInternalStatementFeeRateType1Code:
description: Description that may be available for the statement fee rate type. For a full list of values see `OBInternalStatementFeeRateType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.AER
x-namespaced-enum:
- UK.OBIE.AER
- UK.OBIE.EAR
OBInternalStatementFeeType1Code:
description: Fee type, in a coded form. For a full list of values see `OBInternalStatementFeeType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.Annual
x-namespaced-enum:
- UK.OBIE.Annual
- UK.OBIE.BalanceTransfer
- UK.OBIE.CashAdvance
- UK.OBIE.CashTransaction
- UK.OBIE.ForeignCashTransaction
- UK.OBIE.ForeignTransaction
- UK.OBIE.Gambling
- UK.OBIE.LatePayment
- UK.OBIE.MoneyTransfer
- UK.OBIE.Monthly
- UK.OBIE.Overlimit
- UK.OBIE.PostalOrder
- UK.OBIE.PrizeEntry
- UK.OBIE.StatementCopy
- UK.OBIE.Total
OBInternalStatementInterestFrequency1Code:
description: Specifies the statement fee type requested. For a full list of values see `OBInternalStatementInterestFrequency1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.Monthly
x-namespaced-enum:
- UK.OBIE.Daily
- UK.OBIE.HalfYearly
- UK.OBIE.Monthly
- UK.OBIE.PerStatementDate
- UK.OBIE.Quarterly
- UK.OBIE.Weekly
- UK.OBIE.Yearly
OBExternalStatementInterestRateType1Code:
description: Description that may be available for the statement Interest rate type.
type: string
example: UK.OBIE.FixedRate
x-namespaced-enum:
- UK.OBIE.BOEBaseRate
- UK.OBIE.FixedRate
- UK.OBIE.Gross
- UK.OBIE.LoanProviderBaseRate
- UK.OBIE.Net
OBInternalStatementInterestType1Code:
description: Interest amount type, in a coded form. For a full list of values see `OBInternalStatementInterestType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.Total
x-namespaced-enum:
- UK.OBIE.BalanceTransfer
- UK.OBIE.Cash
- UK.OBIE.EstimatedNext
- UK.OBIE.Purchase
- UK.OBIE.Total
OBInternalStatementRateType1Code:
description: Statement rate type, in a coded form. For a full list of values see `OBInternalStatementRateType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.AnnualCash
x-namespaced-enum:
- UK.OBIE.AnnualBalanceTransfer
- UK.OBIE.AnnualBalanceTransferAfterPromo
- UK.OBIE.AnnualBalanceTransferPromo
- UK.OBIE.AnnualCash
- UK.OBIE.AnnualPurchase
- UK.OBIE.AnnualPurchaseAfterPromo
- UK.OBIE.AnnualPurchasePromo
- UK.OBIE.MonthlyBalanceTransfer
- UK.OBIE.MonthlyCash
- UK.OBIE.MonthlyPurchase
OBInternalStatementType1Code:
description: Statement type, in a coded form. For a full list of values see `OBInternalStatementType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: RegularPeriodic
enum:
- AccountClosure
- AccountOpening
- Annual
- Interim
- RegularPeriodic
OBInternalStatementValueType1Code:
description: Statement value type, in a coded form. For a full list of values see `OBInternalStatementValueType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: UK.OBIE.Credit
x-namespaced-enum:
- UK.OBIE.AirMilesPoints
- UK.OBIE.AirMilesPointsBalance
- UK.OBIE.Credits
- UK.OBIE.Debits
- UK.OBIE.HotelPoints
- UK.OBIE.HotelPointsBalance
- UK.OBIE.RetailShoppingPoints
- UK.OBIE.RetailShoppingPointsBalance
OBFrequency2:
description: >-
For a full list of enumeration values refer to `OBFrequency2Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_internal_CodeSets)
type: string
enum:
- YEAR
- DAIL
- INDA
- MNTH
- QURT
- MIAN
- TEND
- MOVE
- WEEK
OBFrequencyPeriodType:
description: |-
Individual Definitions:
ADHO - Adhoc
YEAR - Annual
DAIL - Daily
INDA - Intra Day
MNTH - Monthly
QURT - Quarterly
WEEK - Weekly
type: string
enum:
- ADHO
- YEAR
- DAIL
- INDA
- MNTH
- QURT
- MIAN
- WEEK
OBFileFormat:
description: >-
For a full list of enumeration values refer to `ExternalDocumentFormat1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_internal_CodeSets)
type: string
enum:
- DPDF
- DXML
- SDSH
- WORD
- XSLT
OBExternalStatusReason1Code:
description: >-
Low level textual error code, for all enum values see
`ExternalReason1Code`
[here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
minLength: 4
maxLength: 4
example: AC17
OBMandateRelatedInformation1:
type: object
description: >-
Provides further details of the mandate signed between the creditor and
the debtor.
required:
- Frequency
properties:
MandateIdentification:
description: >-
Unique identification, as assigned by the creditor, to unambiguously
identify the mandate.
type: string
example: Golfers
minLength: 1
maxLength: 35
Classification:
$ref: '#/components/schemas/OBExternalMandateClassification1Code'
CategoryPurposeCode:
$ref: '#/components/schemas/ExternalCategoryPurpose1Code'
FirstPaymentDateTime:
description: >-
The date on which the first payment for a recurrent credit transfer
will be made.
example: '2024-04-25T12:46:49.425Z'
type: string
format: date-time
RecurringPaymentDateTime:
description: >-
The date on which the first recurring payment for a Standing Order
schedule will be made.
Usage: This must be populated only if the first recurring date is
different to the first payment date. All dates in the JSON payloads
are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
example: '2024-04-25T12:46:49.425Z'
format: date-time
FinalPaymentDateTime:
description: >-
The date on which the final payment for a recurrent credit transfer
will be made.
type: string
example: '2024-04-25T12:46:49.425Z'
format: date-time
Frequency:
$ref: '#/components/schemas/OBFrequency6'
Reason:
description: Reason for the setup of the credit transfer mandate.
type: string
example: To pay monthly memebership
maxLength: 256
minLength: 1
OBMerchantDetails1:
type: object
description: Details of the merchant involved in the transaction.
properties:
MerchantName:
description: Name by which the merchant is known.
type: string
minLength: 1
maxLength: 350
MerchantCategoryCode:
description: >-
Category code conform to ISO 18245, related to the type of services
or goods the merchant provides for the transaction.
type: string
minLength: 3
maxLength: 4
OBPCAData1:
type: object
title: PCA
properties:
ProductDetails:
type: object
title: ProductDetails
properties:
Segment:
description: >-
Market segmentation is a marketing term referring to the
aggregating of prospective buyers into groups, or segments, that
have common needs and respond similarly to a marketing action.
Market segmentation enables companies to target different
categories of consumers who perceive the full value of certain
products and services differently from one another.
Read more: Market Segmentation
http://www.investopedia.com/terms/m/marketsegmentation.asp#ixzz4gfEEalTd
With respect to PCA products, they are segmented in relation to
different markets that they wish to focus on.
title: Segment
type: array
items:
description: >-
Market segmentation is a marketing term referring to the
aggregating of prospective buyers into groups, or segments,
that have common needs and respond similarly to a marketing
action. Market segmentation enables companies to target
different categories of consumers who perceive the full value
of certain products and services differently from one another.
Read more: Market Segmentation
http://www.investopedia.com/terms/m/marketsegmentation.asp#ixzz4gfEEalTd
With respect to PCA products, they are segmented in relation
to different markets that they wish to focus on.
type: string
enum:
- Basic
- BenefitAndReward
- CreditInterest
- Cashback
- General
- Graduate
- Other
- Overdraft
- Packaged
- Premium
- Reward
- Student
- YoungAdult
- Youth
MonthlyMaximumCharge:
description: >-
The maximum relevant charges that could accrue as defined fully
in Part 7 of the CMA order
title: MonthlyMaximumCharge
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
Notes:
description: Optional additional notes to supplement the Core product details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
additionalProperties: false
CreditInterest:
description: >-
Details about the interest that may be payable to the PCA account
holders
type: object
title: CreditInterest
properties:
TierBandSet:
description: >-
The group of tiers or bands for which credit interest can be
applied.
type: array
title: TierBandSet
items:
description: >-
The group of tiers or bands for which credit interest can be
applied.
type: object
properties:
TierBandMethod:
description: >-
The methodology of how credit interest is charged. It can
be:-
1. Banded
Interest rates are banded. i.e. Increasing rate on whole
balance as balance increases.
2. Tiered
Interest rates are tiered. i.e. increasing rate for each
tier as balance increases, but interest paid on tier fixed
for that tier and not on whole balance.
3. Whole
The same interest rate is applied irrespective of the PCA
balance
title: TierBandMethod
type: string
enum:
- Tiered
- Whole
CalculationMethod:
description: Methods of calculating interest
title: CalculationMethod
type: string
enum:
- Compound
- SimpleInterest
Destination:
description: >-
Describes whether accrued interest is payable only to the
PCA or to another bank account
title: Destination
type: string
enum:
- PayAway
- SelfCredit
Notes:
description: >-
Optional additional notes to supplement the Tier Band Set
details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
TierBand:
description: Tier Band Details
type: array
title: TierBand
items:
description: Tier Band Details
type: object
properties:
Identification:
description: >-
Unique and unambiguous identification of a Tier
Band for a PCA.
title: Identification
type: string
minLength: 1
maxLength: 35
TierValueMinimum:
description: >-
Minimum deposit value for which the credit interest
tier applies.
title: TierValueMinimum
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMaximum:
description: >-
Maximum deposit value for which the credit interest
tier applies.
title: TierValueMaximum
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CalculationFrequency:
description: >-
How often is credit interest calculated for the
account.
title: CalculationFrequency
type: string
enum:
- PerAcademicTerm
- Daily
- HalfYearly
- Monthly
- Other
- Quarterly
- PerStatementDate
- Weekly
- Yearly
ApplicationFrequency:
description: >-
How often is interest applied to the PCA for this
tier/band i.e. how often the financial institution
pays accumulated interest to the customer's PCA.
title: ApplicationFrequency
type: string
enum:
- PerAcademicTerm
- Daily
- HalfYearly
- Monthly
- Other
- Quarterly
- PerStatementDate
- Weekly
- Yearly
DepositInterestAppliedCoverage:
description: Amount on which Interest applied.
title: DepositInterestAppliedCoverage
type: string
enum:
- Tiered
- Whole
FixedVariableInterestRateType:
description: Type of interest rate, Fixed or Variable
title: FixedVariableInterestRateType
type: string
enum:
- Fixed
- Variable
AER:
description: >-
The annual equivalent rate (AER) is interest that is
calculated under the assumption that any interest
paid is combined with the original balance and the
next interest payment will be based on the slightly
higher account balance. Overall, this means that
interest can be compounded several times in a year
depending on the number of times that interest
payments are made.
Read more: Annual Equivalent Rate (AER)
http://www.investopedia.com/terms/a/aer.asp#ixzz4gfR7IO1A
title: AER
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
BankInterestRateType:
description: >-
Interest rate types, other than AER, which financial
institutions may use to describe the annual interest
rate payable to the PCA.
title: BankInterestRateType
type: string
enum:
- LinkedBaseRate
- Gross
- Net
- Other
BankInterestRate:
description: Bank Interest for the PCA product
title: BankInterestRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
Notes:
description: >-
Optional additional notes to supplement the Tier
Band details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherBankInterestType:
description: >-
Other interest rate types which are not available in
the standard code list
type: object
title: OtherBankInterestType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file
to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies that are not available
in the standard code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file
to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not available
in the standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file
to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
required:
- TierValueMinimum
- ApplicationFrequency
- FixedVariableInterestRateType
- AER
minItems: 1
required:
- TierBandMethod
- TierBand
minItems: 1
additionalProperties: false
required:
- TierBandSet
Overdraft:
description: Details about Overdraft rates, fees & charges
type: object
title: Overdraft
properties:
Notes:
description: Associated Notes about the overdraft rates
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftTierBandSet:
description: Tier band set details
type: array
title: OverdraftTierBandSet
items:
description: Tier band set details
type: object
properties:
TierBandMethod:
description: >-
The methodology of how overdraft is charged. It can be:
'Whole' Where the same charge/rate is applied to the
entirety of the overdraft balance (where charges are
applicable).
'Tiered' Where different charges/rates are applied
dependent on overdraft maximum and minimum balance amount
tiers defined by the lending financial organisation
'Banded' Where different charges/rates are applied
dependent on overdraft maximum and minimum balance amount
bands defined by a government organisation.
title: TierBandMethod
type: string
enum:
- Tiered
- Whole
- Banded
OverdraftType:
description: >-
An overdraft can either be 'committed' which means that
the facility cannot be withdrawn without reasonable
notification before it's agreed end date, or 'on demand'
which means that the financial institution can demand
repayment at any point in time.
title: OverdraftType
type: string
enum:
- Committed
- OnDemand
- Other
Identification:
description: >-
Unique and unambiguous identification of a Tier Band for
a overdraft product.
title: Identification
type: string
minLength: 1
maxLength: 35
AuthorisedIndicator:
description: >-
Indicates if the Overdraft is authorised (Y) or
unauthorised (N)
title: AuthorisedIndicator
type: boolean
BufferAmount:
description: >-
When a customer exceeds their credit limit, a financial
institution will not charge the customer unauthorised
overdraft charges if they do not exceed by more than the
buffer amount. Note: Authorised overdraft charges may
still apply.
title: BufferAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
Notes:
description: >-
Optional additional notes to supplement the overdraft Tier
Band Set details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftTierBand:
description: Provides overdraft details for a specific tier or band
type: array
title: OverdraftTierBand
items:
description: Provides overdraft details for a specific tier or band
type: object
properties:
Identification:
description: >-
Unique and unambiguous identification of a Tier
Band for a overdraft.
title: Identification
type: string
minLength: 1
maxLength: 35
TierValueMin:
description: Minimum value of Overdraft Tier/Band
title: TierValueMin
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMax:
description: Maximum value of Overdraft Tier/Band
title: TierValueMax
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
OverdraftInterestChargingCoverage:
description: Interest charged on whole amount or tiered/banded
title: OverdraftInterestChargingCoverage
type: string
enum:
- Tiered
- Whole
BankGuaranteedIndicator:
description: >-
Indicates that a bank provides the overdraft limit
up to TierValueMIn to all customers automatically
title: BankGuaranteedIndicator
type: boolean
EAR:
description: >-
EAR means Effective Annual Rate and/or Equivalent
Annual Rate (frequently
used interchangeably), being the actual annual
interest rate of an Overdraft.
title: EAR
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
RepresentativeAPR:
description: >-
An annual percentage rate (APR) is the annual rate
charged for borrowing or earned through an
investment. APR is expressed as a percentage that
represents the actual yearly cost of funds over the
term of a loan. This includes any fees or additional
costs associated with the transaction but does not
take compounding into account.
title: RepresentativeAPR
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
Notes:
description: >-
Optional additional notes to supplement the
Tier/band details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OverdraftFeesCharges:
description: Overdraft fees and charges
type: array
title: OverdraftFeesCharges
items:
description: Overdraft fees and charges
type: object
properties:
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges) that
apply to a particular fee/charge
type: array
title: OverdraftFeeChargeCap
items:
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- AnnualReview
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
OverdraftControlIndicator:
description: >-
Specifies for the overdraft control
feature/benefit
title: OverdraftControlIndicator
type: boolean
MinMaxType:
description: >-
Indicates that this is the minimum/
maximum fee/charge that can be applied
by the financial institution
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on
the number of occurrences rather than
capped at a particular amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for
which the fee/charge is capped
title: CappingPeriod
type: string
enum:
- AcademicTerm
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: >-
Notes related to Overdraft fee charge
cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not
available in the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not
available in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
OverdraftFeeChargeDetail:
description: Details about the fees/charges
type: array
title: OverdraftFeeChargeDetail
items:
description: Details about the fees/charges
type: object
properties:
FeeType:
description: Overdraft fee type
title: FeeType
type: string
enum:
- ArrangedOverdraft
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- AnnualReview
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
OverdraftControlIndicator:
description: >-
Specifies for the overdraft control
feature/benefit
title: OverdraftControlIndicator
type: boolean
IncrementalBorrowingAmount:
description: >-
Every additional tranche of an overdraft
balance to which an overdraft fee is
applied
title: IncrementalBorrowingAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeAmount:
description: >-
Amount charged for an overdraft
fee/charge (where it is charged in terms
of an amount rather than a rate)
title: FeeAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeRate:
description: >-
Rate charged for overdraft fee/charge
(where it is charged in terms of a rate
rather than an amount)
title: FeeRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
FeeRateType:
description: >-
Rate type for overdraft fee/charge
(where it is charged in terms of a rate
rather than an amount)
title: FeeRateType
type: string
enum:
- LinkedBaseRate
- Gross
- Net
- Other
ApplicationFrequency:
description: >-
Frequency at which the overdraft charge
is applied to the account
title: ApplicationFrequency
type: string
enum:
- AccountClosing
- AccountOpening
- AcademicTerm
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAccountAnniversary
- Other
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
CalculationFrequency:
description: >-
How often is the overdraft fee/charge
calculated for the account.
title: CalculationFrequency
type: string
enum:
- AccountClosing
- AccountOpening
- AcademicTerm
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAccountAnniversary
- Other
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
Notes:
description: >-
Free text for capturing any other info
related to Overdraft Fees Charge Details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other Fee type which is not available in
the standard code set
type: object
title: OtherFeeType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherFeeRateType:
description: >-
Other fee rate type code which is not
available in the standard code set
type: object
title: OtherFeeRateType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies that are
not available in the standard code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not
available in the standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge
type: object
title: OverdraftFeeChargeCap
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- AnnualReview
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
OverdraftControlIndicator:
description: >-
Specifies for the overdraft control
feature/benefit
title: OverdraftControlIndicator
type: boolean
MinMaxType:
description: >-
Indicates that this is the minimum/
maximum fee/charge that can be applied
by the financial institution
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on
the number of occurrences rather than
capped at a particular amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for
which the fee/charge is capped
title: CappingPeriod
type: string
enum:
- AcademicTerm
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: >-
Notes related to Overdraft fee charge
cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not
available in the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not
available in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
additionalProperties: false
required:
- FeeType
- MinMaxType
required:
- FeeType
- ApplicationFrequency
minItems: 1
required:
- OverdraftFeeChargeDetail
required:
- TierValueMin
minItems: 1
OverdraftFeesCharges:
description: Overdraft fees and charges details
type: array
title: OverdraftFeesCharges
items:
description: Overdraft fees and charges details
type: object
properties:
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges) that apply
to a particular fee/charge
type: array
title: OverdraftFeeChargeCap
items:
description: >-
Details about any caps (maximum charges) that
apply to a particular fee/charge
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- AnnualReview
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
OverdraftControlIndicator:
description: >-
Specifies for the overdraft control
feature/benefit
title: OverdraftControlIndicator
type: boolean
MinMaxType:
description: >-
Indicates that this is the minimum/ maximum
fee/charge that can be applied by the
financial institution
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on the
number of occurrences rather than capped at a
particular amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for which
the fee/charge is capped
title: CappingPeriod
type: string
enum:
- AcademicTerm
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: Notes related to Overdraft fee charge cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not available in
the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not available
in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
OverdraftFeeChargeDetail:
description: Details about the fees/charges
type: array
title: OverdraftFeeChargeDetail
items:
description: Details about the fees/charges
type: object
properties:
FeeType:
description: Overdraft fee type
title: FeeType
type: string
enum:
- ArrangedOverdraft
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- AnnualReview
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
OverdraftControlIndicator:
description: >-
Specifies for the overdraft control
feature/benefit
title: OverdraftControlIndicator
type: boolean
IncrementalBorrowingAmount:
description: >-
Every additional tranche of an overdraft
balance to which an overdraft fee is applied
title: IncrementalBorrowingAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeAmount:
description: >-
Amount charged for an overdraft fee/charge
(where it is charged in terms of an amount
rather than a rate)
title: FeeAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeRate:
description: >-
Rate charged for overdraft fee/charge (where
it is charged in terms of a rate rather than
an amount)
title: FeeRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
FeeRateType:
description: >-
Rate type for overdraft fee/charge (where it
is charged in terms of a rate rather than an
amount)
title: FeeRateType
type: string
enum:
- LinkedBaseRate
- Gross
- Net
- Other
ApplicationFrequency:
description: >-
Frequency at which the overdraft charge is
applied to the account
title: ApplicationFrequency
type: string
enum:
- AccountClosing
- AccountOpening
- AcademicTerm
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAccountAnniversary
- Other
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
CalculationFrequency:
description: >-
How often is the overdraft fee/charge
calculated for the account.
title: CalculationFrequency
type: string
enum:
- AccountClosing
- AccountOpening
- AcademicTerm
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAccountAnniversary
- Other
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
Notes:
description: >-
Free text for capturing any other info related
to Overdraft Fees Charge Details
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other Fee type which is not available in the
standard code set
type: object
title: OtherFeeType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherFeeRateType:
description: >-
Other fee rate type code which is not
available in the standard code set
type: object
title: OtherFeeRateType
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies that are not
available in the standard code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not
available in the standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OverdraftFeeChargeCap:
description: >-
Details about any caps (maximum charges) that
apply to a particular fee/charge
type: object
title: OverdraftFeeChargeCap
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Overdraft fee type
type: string
enum:
- ArrangedOverdraft
- EmergencyBorrowing
- BorrowingItem
- OverdraftRenewal
- AnnualReview
- OverdraftSetup
- Surcharge
- TempOverdraft
- UnauthorisedBorrowing
- UnauthorisedPaidTrans
- Other
- UnauthorisedUnpaidTrans
minItems: 1
OverdraftControlIndicator:
description: >-
Specifies for the overdraft control
feature/benefit
title: OverdraftControlIndicator
type: boolean
MinMaxType:
description: >-
Indicates that this is the minimum/
maximum fee/charge that can be applied by
the financial institution
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on the
number of occurrences rather than capped
at a particular amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: Cap amount charged for a fee/charge
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for
which the fee/charge is capped
title: CappingPeriod
type: string
enum:
- AcademicTerm
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: Notes related to Overdraft fee charge cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not available
in the standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not
available in the standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an
XML file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of
the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
additionalProperties: false
required:
- FeeType
- MinMaxType
required:
- FeeType
- ApplicationFrequency
minItems: 1
required:
- OverdraftFeeChargeDetail
required:
- TierBandMethod
- OverdraftTierBand
minItems: 1
additionalProperties: false
required:
- OverdraftTierBandSet
OtherFeesCharges:
description: >-
Contains details of fees and charges which are not associated with
either borrowing or features/benefits
type: object
title: OtherFeesCharges
properties:
FeeChargeDetail:
description: Other fees/charges details
type: array
title: FeeChargeDetail
items:
description: Other fees/charges details
type: object
properties:
FeeCategory:
description: >-
Categorisation of fees and charges into standard
categories.
title: FeeCategory
type: string
enum:
- Other
- Servicing
FeeType:
description: Fee/Charge Type
title: FeeType
type: string
enum:
- ServiceCAccountFee
- ServiceCAccountFeeMonthly
- ServiceCOther
- Other
FeeAmount:
description: >-
Fee Amount charged for a fee/charge (where it is charged
in terms of an amount rather than a rate)
title: FeeAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
FeeRate:
description: >-
Rate charged for Fee/Charge (where it is charged in terms
of a rate rather than an amount)
title: FeeRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
FeeRateType:
description: >-
Rate type for Fee/Charge (where it is charged in terms of
a rate rather than an amount)
title: FeeRateType
type: string
enum:
- LinkedBaseRate
- Gross
- Net
- Other
ApplicationFrequency:
description: How frequently the fee/charge is applied to the account
title: ApplicationFrequency
type: string
enum:
- AccountClosing
- AccountOpening
- AcademicTerm
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAccountAnniversary
- Other
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
CalculationFrequency:
description: How frequently the fee/charge is calculated
title: CalculationFrequency
type: string
enum:
- AccountClosing
- AccountOpening
- AcademicTerm
- ChargingPeriod
- Daily
- PerItem
- Monthly
- OnAccountAnniversary
- Other
- PerHour
- PerOccurrence
- PerSheet
- PerTransaction
- PerTransactionAmount
- PerTransactionPercentage
- Quarterly
- SixMonthly
- StatementMonthly
- Weekly
- Yearly
Notes:
description: >-
Optional additional notes to supplement the fee/charge
details.
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeCategoryType:
type: object
title: OtherFeeCategoryType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherFeeType:
description: >-
Other Fee/charge type which is not available in the
standard code set
type: object
title: OtherFeeType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
FeeCategory:
description: >-
Categorisation of fees and charges into standard
categories.
title: FeeCategory
type: string
enum:
- Other
- Servicing
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- FeeCategory
- Name
- Description
OtherFeeRateType:
description: >-
Other fee rate type which is not available in the standard
code set
type: object
title: OtherFeeRateType
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherApplicationFrequency:
description: >-
Other application frequencies not covered in the standard
code list
type: object
title: OtherApplicationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
OtherCalculationFrequency:
description: >-
Other calculation frequency which is not available in
standard code set.
type: object
title: OtherCalculationFrequency
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
additionalProperties: false
required:
- Name
- Description
FeeChargeCap:
description: >-
Details about any caps (maximum charges) that apply to a
particular fee/charge
type: array
title: FeeChargeCap
items:
description: >-
Details about any caps (maximum charges) that apply to a
particular fee/charge
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- ServiceCAccountFee
- ServiceCAccountFeeMonthly
- ServiceCOther
- Other
minItems: 1
MinMaxType:
description: >-
Indicates that this is the minimum/ maximum
fee/charge that can be applied by the financial
institution
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on the number of
occurrences rather than capped at a particular
amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: >-
Cap amount charged for a fee/charge (where it is
charged in terms of an amount rather than a rate)
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for which the
fee/charge is capped
title: CappingPeriod
type: string
enum:
- AcademicTerm
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: >-
Free text for adding extra details for fee charge
cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not available in the
standard code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not available in the
standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an XML
file to identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: >-
Description to describe the purpose of the
code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
FeeApplicableRange:
description: Range or amounts or rates for which the fee/charge applies
type: object
title: FeeApplicableRange
properties:
MinimumAmount:
description: >-
Minimum Amount on which fee/charge is applicable
(where it is expressed as an amount)
title: MinimumAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
MaximumAmount:
description: >-
Maximum Amount on which fee is applicable (where it is
expressed as an amount)
title: MaximumAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
MinimumRate:
description: >-
Minimum rate on which fee/charge is applicable(where
it is expressed as an rate)
title: MinimumRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
MaximumRate:
description: >-
Maximum rate on which fee/charge is applicable(where
it is expressed as an rate)
title: MaximumRate
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
additionalProperties: false
required:
- FeeCategory
- FeeType
- ApplicationFrequency
minItems: 1
FeeChargeCap:
description: >-
Details about any caps (maximum charges) that apply to a
particular fee/charge
type: array
title: FeeChargeCap
items:
description: >-
Details about any caps (maximum charges) that apply to a
particular fee/charge
type: object
properties:
FeeType:
description: Fee/charge type which is being capped
title: FeeType
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- ServiceCAccountFee
- ServiceCAccountFeeMonthly
- ServiceCOther
- Other
minItems: 1
MinMaxType:
description: >-
Indicates that this is the minimum/ maximum fee/charge
that can be applied by the financial institution
title: MinMaxType
type: string
enum:
- Minimum
- Maximum
FeeCapOccurrence:
description: >-
fee/charges are captured dependent on the number of
occurrences rather than capped at a particular amount
title: FeeCapOccurrence
type: number
format: float
FeeCapAmount:
description: >-
Cap amount charged for a fee/charge (where it is charged
in terms of an amount rather than a rate)
title: FeeCapAmount
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CappingPeriod:
description: >-
Period e.g. day, week, month etc. for which the fee/charge
is capped
title: CappingPeriod
type: string
enum:
- AcademicTerm
- Day
- Half Year
- Month
- Quarter
- Week
- Year
Notes:
description: Free text for adding extra details for fee charge cap
title: Notes
type: array
items:
description: maxLength 2000 text
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
description: >-
Other fee type code which is not available in the standard
code set
type: array
title: OtherFeeType
items:
description: >-
Other fee type code which is not available in the
standard code set
type: object
properties:
Code:
description: >-
The four letter Mnemonic used within an XML file to
identify a code
title: Code
type: string
pattern: ^\w{0,4}$
minLength: 0
maxLength: 4
Name:
description: Long name associated with the code
title: Name
type: string
minLength: 1
maxLength: 70
Description:
description: Description to describe the purpose of the code
title: Description
type: string
minLength: 1
maxLength: 350
required:
- Name
- Description
required:
- FeeType
- MinMaxType
additionalProperties: false
required:
- FeeChargeDetail
additionalProperties: false
OBParty2:
type: object
required:
- PartyId
properties:
PartyId:
$ref: '#/components/schemas/PartyId'
PartyNumber:
$ref: '#/components/schemas/PartyNumber'
PartyType:
$ref: '#/components/schemas/OBInternalPartyType1Code'
Name:
$ref: '#/components/schemas/Name_3'
FullLegalName:
$ref: '#/components/schemas/FullLegalName'
LegalStructure:
$ref: '#/components/schemas/OBInternalLegalStructureType1Code'
LEI:
$ref: '#/components/schemas/LEI'
BeneficialOwnership:
description: A flag to indicate a party's beneficial ownership of the related account
type: boolean
AccountRole:
$ref: '#/components/schemas/OBInternalAccountRole1Code'
EmailAddress:
$ref: '#/components/schemas/EmailAddress'
Phone:
$ref: '#/components/schemas/PhoneNumber_0'
Mobile:
$ref: '#/components/schemas/PhoneNumber_1'
Relationships:
$ref: '#/components/schemas/OBPartyRelationships1'
Address:
type: array
items:
$ref: '#/components/schemas/OBPostalAddress7'
additionalProperties: false
OBPartyRelationships1:
type: object
description: The Party's relationships with other resources.
properties:
Account:
type: object
required:
- Related
- Id
description: Relationship to the Account resource.
properties:
Related:
description: Absolute URI to the related resource.
type: string
example: https://api.alphabank.com/open-banking/v4.0/aisp/accounts/89019
format: uri
Id:
description: >-
Unique identification as assigned by the ASPSP to uniquely
identify the related resource.
type: string
example: '89019'
minLength: 1
maxLength: 40
OBPostalAddress7:
type: object
description: >-
Information that locates and identifies a specific address, as defined
by postal services.
properties:
AddressType:
$ref: '#/components/schemas/OBAddressType2Code'
Department:
description: Identification of a division of a large organisation or building.
example: Finance
type: string
minLength: 1
maxLength: 70
SubDepartment:
description: >-
Identification of a sub-division of a large organisation or
building.
example: Payroll
type: string
minLength: 1
maxLength: 70
StreetName:
$ref: '#/components/schemas/StreetName'
BuildingNumber:
$ref: '#/components/schemas/BuildingNumber'
BuildingName:
$ref: '#/components/schemas/BuildingName'
Floor:
$ref: '#/components/schemas/Floor'
UnitNumber:
$ref: '#/components/schemas/UnitNumber'
Room:
$ref: '#/components/schemas/Room'
PostBox:
$ref: '#/components/schemas/PostBox'
TownLocationName:
$ref: '#/components/schemas/TownName'
DistrictName:
$ref: '#/components/schemas/DistrictName'
CareOf:
$ref: '#/components/schemas/CareOf'
PostCode:
$ref: '#/components/schemas/PostCode'
TownName:
$ref: '#/components/schemas/TownName'
CountrySubDivision:
description: Identifies a subdivision of a country such as state, region, county.
type: string
minLength: 1
maxLength: 35
Country:
description: Nation with its own government.
type: string
pattern: ^[A-Z]{2,2}$
AddressLine:
type: array
items:
description: >-
Information that locates and identifies a specific address, as
defined by postal services, presented in free format text.
type: string
minLength: 1
maxLength: 70
minItems: 0
maxItems: 7
OBRate1_0:
description: >-
Rate charged for Statement Fee (where it is charged in terms of a rate rather than an amount)
example: 0.05
type: number
OBRate1_1:
description: >-
Rate for Statement Interest (where it is applicable in terms of a rate rather than an amount)
example: 0.05
type: number
OBReadAccount6:
type: object
required:
- Data
properties:
Data:
type: object
properties:
Account:
type: array
items:
$ref: '#/components/schemas/OBAccount6'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadBalance1:
type: object
required:
- Data
properties:
Data:
type: object
required:
- Balance
properties:
Balance:
type: array
items:
type: object
description: Set of elements used to define the balance details.
required:
- AccountId
- CreditDebitIndicator
- Type
- DateTime
- Amount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_2'
Type:
$ref: '#/components/schemas/OBBalanceType1Code'
DateTime:
description: >-
Indicates the date (and time) of the balance. All dates in
the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Amount:
type: object
required:
- Amount
- Currency
description: Amount of money of the cash balance.
properties:
Amount:
$ref: >-
#/components/schemas/OBActiveCurrencyAndAmount_SimpleType
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
SubType:
description: >-
Balance sub type, in a coded form. Default if not specified is BCUR of the account
type: string
enum:
- BCUR
- LCUR
default: BCUR
CreditLine:
type: array
items:
type: object
description: >-
Set of elements used to provide details on the credit
line.
required:
- Included
properties:
Included:
description: >-
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.
type: boolean
Type:
description: >-
Limit type, in a coded form.
For a full list of enumeration values refer to `OBInternalLimitType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- Available
- Credit
- Emergency
- Pre-Agreed
- Temporary
Amount:
type: object
required:
- Amount
- Currency
description: Amount of money of the credit line.
properties:
Amount:
$ref: >-
#/components/schemas/OBActiveCurrencyAndAmount_SimpleType
Currency:
$ref: >-
#/components/schemas/ActiveOrHistoricCurrencyCode_1
LocalAmount:
type: object
required:
- Amount
- Currency
description: >-
Optional component providing the equivalent of Amount in
local currency. Default is Local Currency (LCUR) if not
specified
properties:
Amount:
$ref: >-
#/components/schemas/OBActiveCurrencyAndAmount_SimpleType
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
SubType:
description: >-
Balance sub type, in a coded form. Default if not specified is LCUR of the account
type: string
enum:
- BCUR
- LCUR
default: LCUR
minItems: 1
TotalValue:
type: object
required:
- Amount
- Currency
description: Combined sum of all Amounts in the accounts base currency
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadBeneficiary5:
type: object
required:
- Data
properties:
Data:
type: object
properties:
Beneficiary:
type: array
items:
$ref: '#/components/schemas/OBBeneficiary5'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
OBReadConsent1:
type: object
required:
- Data
- Risk
properties:
Data:
type: object
required:
- Permissions
properties:
Permissions:
type: array
items:
description: >-
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 ASPSP.
For a full list of enumeration values refer to `OBInternalPermissions1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_internal_CodeSets)
type: string
enum:
- ReadAccountsBasic
- ReadAccountsDetail
- ReadBalances
- ReadBeneficiariesBasic
- ReadBeneficiariesDetail
- ReadDirectDebits
- ReadOffers
- ReadPAN
- ReadParty
- ReadPartyPSU
- ReadProducts
- ReadScheduledPaymentsBasic
- ReadScheduledPaymentsDetail
- ReadStandingOrdersBasic
- ReadStandingOrdersDetail
- ReadStatementsBasic
- ReadStatementsDetail
- ReadTransactionsBasic
- ReadTransactionsCredits
- ReadTransactionsDebits
- ReadTransactionsDetail
minItems: 1
ExpirationDateTime:
description: >-
Specified date and time the permissions will expire.
If this is not populated, the permissions will be open ended. All
dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
TransactionFromDateTime:
description: >-
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. All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
TransactionToDateTime:
description: >-
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. All
dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Risk:
$ref: '#/components/schemas/OBRisk2'
OBReadConsentResponse1:
type: object
required:
- Data
- Risk
properties:
Data:
type: object
required:
- ConsentId
- CreationDateTime
- Status
- StatusUpdateDateTime
- Permissions
properties:
ConsentId:
description: >-
Unique identification as assigned to identify the account access
consent resource.
type: string
minLength: 1
maxLength: 128
CreationDateTime:
$ref: '#/components/schemas/CreationDateTime'
Status:
description: Specifies the status of consent resource in code form.
type: string
enum:
- AWAU
- RJCT
- AUTH
- EXPD
- CANC
StatusReason:
type: array
items:
$ref: '#/components/schemas/OBStatusReason'
description: Specifies the status reason.
StatusUpdateDateTime:
$ref: '#/components/schemas/StatusUpdateDateTime'
Permissions:
type: array
items:
description: >-
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 ASPSP.
For a full list of enumeration values refer to `OBInternalPermissions1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_internal_CodeSets)
type: string
enum:
- ReadAccountsBasic
- ReadAccountsDetail
- ReadBalances
- ReadBeneficiariesBasic
- ReadBeneficiariesDetail
- ReadDirectDebits
- ReadOffers
- ReadPAN
- ReadParty
- ReadPartyPSU
- ReadProducts
- ReadScheduledPaymentsBasic
- ReadScheduledPaymentsDetail
- ReadStandingOrdersBasic
- ReadStandingOrdersDetail
- ReadStatementsBasic
- ReadStatementsDetail
- ReadTransactionsBasic
- ReadTransactionsCredits
- ReadTransactionsDebits
- ReadTransactionsDetail
minItems: 1
ExpirationDateTime:
description: >-
Specified date and time the permissions will expire.
If this is not populated, the permissions will be open ended. All
dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
TransactionFromDateTime:
description: >-
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. All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
TransactionToDateTime:
description: >-
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. All
dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Risk:
$ref: '#/components/schemas/OBRisk2'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadDataStatement2:
type: object
properties:
Statement:
type: array
items:
$ref: '#/components/schemas/OBStatement2'
additionalProperties: false
OBReadDataTransaction6:
type: object
properties:
Transaction:
type: array
items:
$ref: '#/components/schemas/OBTransaction6'
additionalProperties: false
OBReadDirectDebit2:
type: object
required:
- Data
properties:
Data:
type: object
properties:
DirectDebit:
type: array
items:
type: object
description: Account to or from which a cash entry is made.
required:
- AccountId
- Name
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
DirectDebitId:
$ref: '#/components/schemas/DirectDebitId'
DirectDebitStatusCode:
$ref: '#/components/schemas/ExternalMandateStatus1Code'
MandateRelatedInformation:
$ref: '#/components/schemas/OBMandateRelatedInformation1'
Name:
$ref: '#/components/schemas/Name_2'
PreviousPaymentDateTime:
$ref: '#/components/schemas/PreviousPaymentDateTime'
PreviousPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_0'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadOffer1:
type: object
required:
- Data
properties:
Data:
type: object
properties:
Offer:
type: array
items:
type: object
required:
- AccountId
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
OfferId:
description: >-
A unique and immutable identifier used to identify the
offer resource. This identifier has no meaning to the
account owner.
type: string
example: Offer1
minLength: 1
maxLength: 40
OfferType:
description: Offer type, in a coded form. For a full list of values refer to `OBExternalOfferType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
example: LimitIncrease
enum:
- BalanceTransfer
- LimitIncrease
- MoneyTransfer
- Other
- PromotionalRate
Description:
description: Further details of the offer.
type: string
example: Credit limit increase for the account up to £10000.00
minLength: 1
maxLength: 500
StartDateTime:
description: >-
Date and time at which the offer starts. All dates in the
JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
example: '2024-05-29T00:00:00Z'
format: date-time
EndDateTime:
description: >-
Date and time at which the offer ends. All dates in the
JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
example: '2024-06-29T00:00:00Z'
format: date-time
Rate:
description: Rate associated with the offer type.
type: string
example: '100.00'
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
Value:
description: Value associated with the offer type.
example: 10
type: integer
Term:
description: Further details of the term of the offer.
type: string
example: Starting first of the month and ending at the end of year
minLength: 1
maxLength: 500
URL:
description: >-
URL (Uniform Resource Locator) where documentation on the
offer can be found
type: string
example: http://modelbank.com/offer/offer1
minLength: 1
maxLength: 256
Amount:
type: object
required:
- Amount
- Currency
description: Amount of money associated with the offer type.
properties:
Amount:
$ref: >-
#/components/schemas/OBActiveCurrencyAndAmount_SimpleType
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
Fee:
type: object
required:
- Amount
- Currency
description: Fee associated with the offer type.
properties:
Amount:
$ref: >-
#/components/schemas/OBActiveCurrencyAndAmount_SimpleType
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadParty2:
type: object
required:
- Data
properties:
Data:
type: object
properties:
Party:
$ref: '#/components/schemas/OBParty2'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadParty3:
type: object
required:
- Data
properties:
Data:
type: object
properties:
Party:
type: array
items:
$ref: '#/components/schemas/OBParty2'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadProduct2:
type: object
required:
- Data
description: >-
Product details of Other Product which is not available in the standard
list
properties:
Data:
type: object
description: Aligning with the read write specs structure.
properties:
Product:
type: array
items:
type: object
description: Product details associated with the Account
required:
- AccountId
- ProductType
properties:
ProductName:
description: >-
The name of the Product used for marketing purposes from a
customer perspective. I.e. what the customer would
recognise.
type: string
example: 321 Product
minLength: 1
maxLength: 350
ProductId:
description: >-
Identifier within the parent organisation for the product. Must be unique in the organisation
type: string
example: 51B
minLength: 1
maxLength: 40
AccountId:
$ref: '#/components/schemas/AccountId'
SecondaryProductId:
description: >-
Any secondary Identification which supports Product
Identifier to uniquely identify the current account
banking products.
type: string
example: CA78
minLength: 1
maxLength: 70
ProductType:
description: >-
Descriptive code for the product category.
For a full list refer to `OBInternalProductType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
If ProductType - "Other" is chosen, the object OtherProductType must be populated with name, and description.
type: string
example: PersonalCurrentAccount
enum:
- BusinessCurrentAccount
- CommercialCreditCard
- Other
- PersonalCurrentAccount
- SMELoan
MarketingStateId:
description: >-
Unique and unambiguous identification of a Product
Marketing State.
type: string
example: '22878123'
minLength: 1
maxLength: 35
OtherProductType:
type: object
required:
- Name
- Description
description: 'This field provides extension to the ProductType enumeration. If ProductType - "Other" is chosen, this field must be populated with name, and description for ASPSP specific product type.'
properties:
Name:
description: Name of "Other" product type.
type: string
example: e-Wallet
minLength: 1
maxLength: 350
Description:
description: Description of "Other" product type
type: string
example: Virtual wallet
minLength: 1
maxLength: 350
ProductDetails:
type: object
properties:
Segment:
type: array
items:
description: >-
Market segmentation is a marketing term
referring to the aggregating of prospective
buyers into groups, or segments, that have
common needs and respond similarly to a
marketing action. Market segmentation enables
companies to target different categories of
consumers who perceive the full value of certain
products and services differently from one
another.
Read more: Market Segmentation
http://www.investopedia.com/terms/m/marketsegmentation.asp#ixzz4gfEEalTd
type: string
enum:
- GEAS
- GEBA
- GEBR
- GEBU
- GECI
- GECS
- GEFB
- GEFG
- GEG
- GEGR
- GEGS
- GEOT
- GEOV
- GEPA
- GEPR
- GERE
- GEST
- GEYA
- GEYO
- PSCA
- PSES
- PSNC
- PSNP
- PSRG
- PSSS
- PSST
- PSSW
FeeFreeLength:
description: The length/duration of the fee free period
type: integer
FeeFreeLengthPeriod:
description: >-
The unit of period (days, weeks, months etc.) of
the promotional length
type: string
enum:
- PACT
- PDAY
- PHYR
- PMTH
- PQTR
- PWEK
- PYER
MonthlyMaximumCharge:
description: >-
The maximum relevant charges that could accrue as
defined fully in Part 7 of the CMA order
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
Notes:
type: array
items:
description: >-
Optional additional notes to supplement the Core
product details
type: string
minLength: 1
maxLength: 2000
OtherSegment:
$ref: '#/components/schemas/OB_OtherCodeType1_0'
CreditInterest:
type: object
required:
- TierBandSet
description: >-
Details about the interest that may be payable to the
Account holders
properties:
TierBandSet:
type: array
items:
type: object
description: >-
The group of tiers or bands for which credit
interest can be applied.
required:
- TierBandMethod
- Destination
- TierBand
properties:
TierBandMethod:
description: >-
The methodology of how credit interest is
paid/applied. It can be:-
1. Banded
Interest rates are banded. i.e. Increasing
rate on whole balance as balance increases.
2. Tiered
Interest rates are tiered. i.e. increasing
rate for each tier as balance increases, but
interest paid on tier fixed for that tier
and not on whole balance.
3. Whole
The same interest rate is applied
irrespective of the product holder's account
balance
type: string
enum:
- INBA
- INTI
- INWH
CalculationMethod:
$ref: >-
#/components/schemas/OB_InterestCalculationMethod1Code
Destination:
description: >-
Describes whether accrued interest is
payable only to the BCA or to another bank
account
type: string
enum:
- INOT
- INPA
- INSC
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the Tier Band Set details
type: string
minLength: 1
maxLength: 2000
OtherCalculationMethod:
$ref: '#/components/schemas/OB_OtherCodeType1_0'
OtherDestination:
$ref: '#/components/schemas/OB_OtherCodeType1_0'
TierBand:
type: array
items:
type: object
description: Tier Band Details
required:
- TierValueMinimum
- ApplicationFrequency
- FixedVariableInterestRateType
- AER
properties:
Identification:
description: >-
Unique and unambiguous identification of
a Tier Band for the Product.
type: string
minLength: 1
maxLength: 35
TierValueMinimum:
description: >-
Minimum deposit value for which the
credit interest tier applies.
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMaximum:
description: >-
Maximum deposit value for which the
credit interest tier applies.
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
CalculationFrequency:
description: >-
How often is credit interest calculated
for the account.
type: string
enum:
- FQAT
- FQDY
- FQHY
- FQMY
- FQOT
- FQQY
- FQSD
- FQWY
- FQYY
ApplicationFrequency:
description: >-
How often is interest applied to the
Product for this tier/band i.e. how
often the financial institution pays
accumulated interest to the customer's
account.
type: string
enum:
- FQAT
- FQDY
- FQHY
- FQMY
- FQOT
- FQQY
- FQSD
- FQWY
- FQYY
DepositInterestAppliedCoverage:
description: Amount on which Interest applied.
type: string
enum:
- INBA
- INTI
- INWH
FixedVariableInterestRateType:
$ref: >-
#/components/schemas/OB_InterestFixedVariableType1Code
AER:
description: >-
The annual equivalent rate (AER) is
interest that is calculated under the
assumption that any interest paid is
combined with the original balance and
the next interest payment will be based
on the slightly higher account balance.
Overall, this means that interest can be
compounded several times in a year
depending on the number of times that
interest payments are made.
Read more: Annual Equivalent Rate (AER)
http://www.investopedia.com/terms/a/aer.asp#ixzz4gfR7IO1A
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
BankInterestRateType:
description: >-
Interest rate types, other than AER,
which financial institutions may use to
describe the annual interest rate
payable to the account holder's account.
type: string
enum:
- INBB
- INFR
- INGR
- INLR
- INNE
- INOT
BankInterestRate:
description: Bank Interest for the product
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the Tier Band details
type: string
minLength: 1
maxLength: 2000
OtherBankInterestType:
type: object
required:
- Name
- Description
description: >-
Other interest rate types which are not
available in the standard code list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OtherApplicationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_1'
OtherCalculationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_2'
minItems: 1
minItems: 1
Overdraft:
type: object
required:
- OverdraftTierBandSet
description: Borrowing details
properties:
Notes:
type: array
items:
description: Associated Notes about the overdraft rates
type: string
minLength: 1
maxLength: 2000
OverdraftTierBandSet:
type: array
items:
type: object
description: Tier band set details
required:
- TierBandMethod
- OverdraftTierBand
properties:
TierBandMethod:
description: >-
The methodology of how overdraft is charged.
It can be:
'Whole' Where the same charge/rate is
applied to the entirety of the overdraft
balance (where charges are applicable).
'Tiered' Where different charges/rates are
applied dependent on overdraft maximum and
minimum balance amount tiers defined by the
lending financial organisation
'Banded' Where different charges/rates are
applied dependent on overdraft maximum and
minimum balance amount bands defined by a
government organisation.
type: string
enum:
- INBA
- INTI
- INWH
OverdraftType:
description: >-
An overdraft can either be 'committed' which
means that the facility cannot be withdrawn
without reasonable notification before it's
agreed end date, or 'on demand' which means
that the financial institution can demand
repayment at any point in time.
type: string
enum:
- OVCO
- OVOD
- OVOT
Identification:
description: >-
Unique and unambiguous identification of a
Tier Band for a overdraft product.
type: string
minLength: 1
maxLength: 35
AuthorisedIndicator:
description: >-
Indicates if the Overdraft is authorised (Y)
or unauthorised (N)
type: boolean
BufferAmount:
description: >-
When a customer exceeds their credit limit,
a financial institution will not charge the
customer unauthorised overdraft charges if
they do not exceed by more than the buffer
amount. Note: Authorised overdraft charges
may still apply.
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the overdraft Tier Band Set details
type: string
minLength: 1
maxLength: 2000
OverdraftTierBand:
type: array
items:
type: object
description: >-
Provides overdraft details for a specific
tier or band
required:
- TierValueMin
properties:
Identification:
description: >-
Unique and unambiguous identification of
a Tier Band for a overdraft.
type: string
minLength: 1
maxLength: 35
TierValueMin:
description: Minimum value of Overdraft Tier/Band
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMax:
description: Maximum value of Overdraft Tier/Band
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
EAR:
description: >-
EAR means Effective Annual Rate and/or
Equivalent Annual Rate (frequently
used interchangeably), being the actual
annual interest rate of an Overdraft.
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
AgreementLengthMin:
description: >-
Specifies the minimum length of a band
for a fixed overdraft agreement
type: integer
AgreementLengthMax:
description: >-
Specifies the maximum length of a band
for a fixed overdraft agreement
type: integer
AgreementPeriod:
description: >-
Specifies the period of a fixed length
overdraft agreement
type: string
enum:
- PACT
- PDAY
- PHYR
- PMTH
- PQTR
- PWEK
- PYER
OverdraftInterestChargingCoverage:
description: >-
Refers to which interest rate is applied
when interests are tiered. For example,
if an overdraft balance is 2k and the
interest tiers are:- 0- 500 0.1%,
500-1000 0.2%, 1000-10000 0.5%, then the
applicable interest rate could either be
0.5% of the entire balance (since the
account balance sits in the top interest
tier) or
(0.1%*500)+(0.2%*500)+(0.5%*1000). In
the 1st situation, we say the interest
is applied to the Whole of the account
balance, and in the 2nd that it is
Tiered .
type: string
enum:
- INBA
- INTI
- INWH
BankGuaranteedIndicator:
description: >-
Indicates whether the advertised
overdraft rate is guaranteed to be
offered to a borrower by the bank e.g.
if it s part of a government scheme, or
whether the rate may vary dependent on
the applicant s circumstances.
type: boolean
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the Tier/band details
type: string
minLength: 1
maxLength: 2000
OverdraftFeesCharges:
type: array
items:
type: object
description: Overdraft fees and charges
required:
- OverdraftFeeChargeDetail
properties:
OverdraftFeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount
(in gbp), an amount (in items) or a
rate.
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FBAO
- FBAR
- FBEB
- FBIT
- FBOR
- FBOS
- FBSC
- FBTO
- FBUB
- FBUT
- FTOT
- FTUT
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_0'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_0'
CappingPeriod:
$ref: '#/components/schemas/OB_Period1Code'
Notes:
type: array
items:
description: >-
Notes related to Overdraft fee charge
cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OverdraftFeeChargeDetail:
type: array
items:
type: object
description: Details about the fees/charges
required:
- FeeType
- ApplicationFrequency
properties:
FeeType:
$ref: >-
#/components/schemas/OB_OverdraftFeeType1Code
NegotiableIndicator:
description: >-
Indicates whether fee and charges are
negotiable
type: boolean
OverdraftControlIndicator:
description: >-
Indicates if the fee/charge is already
covered by an 'Overdraft Control' fee or
not.
type: boolean
IncrementalBorrowingAmount:
$ref: '#/components/schemas/OB_Amount1_1'
FeeAmount:
$ref: '#/components/schemas/OB_Amount1_2'
FeeRate:
$ref: '#/components/schemas/OB_Rate1_0'
FeeRateType:
$ref: >-
#/components/schemas/OB_InterestRateType1Code_0
ApplicationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_0
CalculationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_1
Notes:
type: array
items:
description: >-
Free text for capturing any other info
related to Overdraft Fees Charge Details
type: string
minLength: 1
maxLength: 2000
OverdraftFeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount
(in gbp), an amount (in items) or a
rate.
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FBAO
- FBAR
- FBEB
- FBIT
- FBOR
- FBOS
- FBSC
- FBTO
- FBUB
- FBUT
- FTOT
- FTUT
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_0'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_0'
CappingPeriod:
$ref: '#/components/schemas/OB_Period1Code'
Notes:
type: array
items:
description: >-
Notes related to Overdraft fee charge
cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OtherFeeType:
$ref: '#/components/schemas/OB_OtherCodeType1_3'
OtherFeeRateType:
$ref: '#/components/schemas/OB_OtherCodeType1_4'
OtherApplicationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_1'
OtherCalculationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_2'
minItems: 1
minItems: 1
OverdraftFeesCharges:
type: array
items:
type: object
description: Overdraft fees and charges details
required:
- OverdraftFeeChargeDetail
properties:
OverdraftFeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount
(in gbp), an amount (in items) or a
rate.
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FBAO
- FBAR
- FBEB
- FBIT
- FBOR
- FBOS
- FBSC
- FBTO
- FBUB
- FBUT
- FTOT
- FTUT
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_0'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_0'
CappingPeriod:
$ref: '#/components/schemas/OB_Period1Code'
Notes:
type: array
items:
description: >-
Notes related to Overdraft fee charge
cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OverdraftFeeChargeDetail:
type: array
items:
type: object
description: Details about the fees/charges
required:
- FeeType
- ApplicationFrequency
properties:
FeeType:
$ref: >-
#/components/schemas/OB_OverdraftFeeType1Code
NegotiableIndicator:
description: >-
Indicates whether fee and charges are
negotiable
type: boolean
OverdraftControlIndicator:
description: >-
Indicates if the fee/charge is already
covered by an 'Overdraft Control' fee or
not.
type: boolean
IncrementalBorrowingAmount:
$ref: '#/components/schemas/OB_Amount1_1'
FeeAmount:
$ref: '#/components/schemas/OB_Amount1_2'
FeeRate:
$ref: '#/components/schemas/OB_Rate1_0'
FeeRateType:
$ref: >-
#/components/schemas/OB_InterestRateType1Code_0
ApplicationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_0
CalculationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_1
Notes:
type: array
items:
description: >-
Free text for capturing any other info
related to Overdraft Fees Charge Details
type: string
minLength: 1
maxLength: 2000
OverdraftFeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (maximum charges)
that apply to a particular fee/charge.
Capping can either be based on an amount
(in gbp), an amount (in items) or a
rate.
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FBAO
- FBAR
- FBEB
- FBIT
- FBOR
- FBOS
- FBSC
- FBTO
- FBUB
- FBUT
- FTOT
- FTUT
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_0'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_0'
CappingPeriod:
$ref: '#/components/schemas/OB_Period1Code'
Notes:
type: array
items:
description: >-
Notes related to Overdraft fee charge
cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OtherFeeType:
$ref: '#/components/schemas/OB_OtherCodeType1_3'
OtherFeeRateType:
$ref: '#/components/schemas/OB_OtherCodeType1_4'
OtherApplicationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_1'
OtherCalculationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_2'
minItems: 1
minItems: 1
LoanInterest:
type: object
required:
- LoanInterestTierBandSet
description: >-
Details about the interest that may be payable to the
SME Loan holders
properties:
Notes:
type: array
items:
description: >-
Optional additional notes to supplement the
LoanInterest
type: string
minLength: 1
maxLength: 2000
LoanInterestTierBandSet:
type: array
items:
type: object
description: >-
The group of tiers or bands for which debit
interest can be applied.
required:
- TierBandMethod
- CalculationMethod
- LoanInterestTierBand
properties:
TierBandMethod:
description: >-
The methodology of how credit interest is
charged. It can be:-
1. Banded
Interest rates are banded. i.e. Increasing
rate on whole balance as balance increases.
2. Tiered
Interest rates are tiered. i.e. increasing
rate for each tier as balance increases, but
interest paid on tier fixed for that tier
and not on whole balance.
3. Whole
The same interest rate is applied
irrespective of the SME Loan balance
type: string
enum:
- INBA
- INTI
- INWH
Identification:
description: >-
Loan interest tierbandset identification.
Used by loan providers for internal use
purpose.
type: string
minLength: 1
maxLength: 35
CalculationMethod:
$ref: >-
#/components/schemas/OB_InterestCalculationMethod1Code
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the Tier Band Set details
type: string
minLength: 1
maxLength: 2000
OtherCalculationMethod:
$ref: '#/components/schemas/OB_OtherCodeType1_0'
LoanInterestTierBand:
type: array
items:
type: object
description: Tier Band Details
required:
- TierValueMinimum
- TierValueMinTerm
- MinTermPeriod
- FixedVariableInterestRateType
- RepAPR
properties:
Identification:
description: >-
Unique and unambiguous identification of
a Tier Band for a SME Loan.
type: string
minLength: 1
maxLength: 35
TierValueMinimum:
description: >-
Minimum loan value for which the loan
interest tier applies.
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMaximum:
description: >-
Maximum loan value for which the loan
interest tier applies.
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
TierValueMinTerm:
description: >-
Minimum loan term for which the loan
interest tier applies.
type: integer
MinTermPeriod:
description: >-
The unit of period (days, weeks, months
etc.) of the Minimum Term
type: string
enum:
- PACT
- PDAY
- PHYR
- PMTH
- PQTR
- PWEK
- PYER
TierValueMaxTerm:
description: >-
Maximum loan term for which the loan
interest tier applies.
type: integer
MaxTermPeriod:
description: >-
The unit of period (days, weeks, months
etc.) of the Maximum Term
type: string
enum:
- PACT
- PDAY
- PHYR
- PMTH
- PQTR
- PWEK
- PYER
FixedVariableInterestRateType:
$ref: >-
#/components/schemas/OB_InterestFixedVariableType1Code
RepAPR:
description: >-
The annual equivalent rate (AER) is
interest that is calculated under the
assumption that any interest paid is
combined with the original balance and
the next interest payment will be based
on the slightly higher account balance.
Overall, this means that interest can be
compounded several times in a year
depending on the number of times that
interest payments are made.
For SME Loan, this APR is the
representative APR which includes any
account fees.
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
LoanProviderInterestRateType:
description: >-
Interest rate types, other than APR,
which financial institutions may use to
describe the annual interest rate
payable for the SME Loan.
type: string
enum:
- INBB
- INFR
- INGR
- INLR
- INNE
- INOT
LoanProviderInterestRate:
description: >-
Loan provider Interest for the SME Loan
product
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the Tier Band details
type: string
minLength: 1
maxLength: 2000
OtherLoanProviderInterestRateType:
type: object
required:
- Name
- Description
description: >-
Other loan interest rate types which are
not available in the standard code list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
LoanInterestFeesCharges:
type: array
items:
type: object
description: >-
Contains details of fees and charges
which are not associated with either
LoanRepayment or features/benefits
required:
- LoanInterestFeeChargeDetail
properties:
LoanInterestFeeChargeDetail:
type: array
items:
type: object
description: Other fees/charges details
required:
- FeeType
- ApplicationFrequency
- CalculationFrequency
properties:
FeeType:
$ref: '#/components/schemas/OB_FeeType1Code'
NegotiableIndicator:
description: >-
Fee/charge which is usually negotiable
rather than a fixed amount
type: boolean
FeeAmount:
$ref: '#/components/schemas/OB_Amount1_3'
FeeRate:
$ref: '#/components/schemas/OB_Rate1_1'
FeeRateType:
$ref: >-
#/components/schemas/OB_InterestRateType1Code_1
ApplicationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_2
CalculationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_3
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the fee/charge details.
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
$ref: >-
#/components/schemas/OB_OtherFeeChargeDetailType
OtherFeeRateType:
$ref: '#/components/schemas/OB_OtherCodeType1_5'
OtherApplicationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_6'
OtherCalculationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_7'
minItems: 1
LoanInterestFeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (minimum/maximum
charges) that apply to a particular
fee/charge
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FEPF
- FTOT
- FYAF
- FYAM
- FYAQ
- FYCP
- FYDB
- FYMI
- FYXX
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_1'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_4'
CappingPeriod:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_4
Notes:
type: array
items:
description: >-
Free text for adding extra details for
fee charge cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
minItems: 1
LoanInterestFeesCharges:
type: array
items:
type: object
description: >-
Contains details of fees and charges which
are not associated with either
LoanRepayment or features/benefits
required:
- LoanInterestFeeChargeDetail
properties:
LoanInterestFeeChargeDetail:
type: array
items:
type: object
description: Other fees/charges details
required:
- FeeType
- ApplicationFrequency
- CalculationFrequency
properties:
FeeType:
$ref: '#/components/schemas/OB_FeeType1Code'
NegotiableIndicator:
description: >-
Fee/charge which is usually negotiable
rather than a fixed amount
type: boolean
FeeAmount:
$ref: '#/components/schemas/OB_Amount1_3'
FeeRate:
$ref: '#/components/schemas/OB_Rate1_1'
FeeRateType:
$ref: >-
#/components/schemas/OB_InterestRateType1Code_1
ApplicationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_2
CalculationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_3
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the fee/charge details.
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
$ref: >-
#/components/schemas/OB_OtherFeeChargeDetailType
OtherFeeRateType:
$ref: '#/components/schemas/OB_OtherCodeType1_5'
OtherApplicationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_6'
OtherCalculationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_7'
minItems: 1
LoanInterestFeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (minimum/maximum
charges) that apply to a particular
fee/charge
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FEPF
- FTOT
- FYAF
- FYAM
- FYAQ
- FYCP
- FYDB
- FYMI
- FYXX
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_1'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_4'
CappingPeriod:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_4
Notes:
type: array
items:
description: >-
Free text for adding extra details for
fee charge cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
minItems: 1
Repayment:
type: object
description: Repayment details of the Loan product
properties:
RepaymentType:
description: Repayment type
type: string
enum:
- USBA
- USBU
- USCI
- USCS
- USER
- USFA
- USFB
- USFI
- USIO
- USOT
- USPF
- USRW
- USSL
RepaymentFrequency:
description: Repayment frequency
type: string
enum:
- SMDA
- SMFL
- SMFO
- SMHY
- SMMO
- SMOT
- SMQU
- SMWE
- SMYE
AmountType:
description: >-
The repayment is for paying just the interest only
or both interest and capital or bullet amount or
balance to date etc
type: string
enum:
- RABD
- RABL
- RACI
- RAFC
- RAIO
- RALT
- USOT
Notes:
type: array
items:
description: >-
Optional additional notes to supplement the
Repayment
type: string
minLength: 1
maxLength: 2000
OtherRepaymentType:
type: object
required:
- Name
- Description
description: >-
Other repayment type which is not in the standard
code list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OtherRepaymentFrequency:
type: object
required:
- Name
- Description
description: >-
Other repayment frequency which is not in the
standard code list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OtherAmountType:
type: object
required:
- Name
- Description
description: >-
Other amount type which is not in the standard
code list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
RepaymentFeeCharges:
type: object
required:
- RepaymentFeeChargeDetail
description: >-
Applicable fee/charges for repayment such as
prepayment, full early repayment or non repayment.
properties:
RepaymentFeeChargeDetail:
type: array
items:
type: object
description: >-
Details about specific fees/charges that are
applied for repayment
required:
- FeeType
- ApplicationFrequency
- CalculationFrequency
properties:
FeeType:
$ref: '#/components/schemas/OB_FeeType1Code'
NegotiableIndicator:
description: >-
Fee/charge which is usually negotiable
rather than a fixed amount
type: boolean
FeeAmount:
$ref: '#/components/schemas/OB_Amount1_3'
FeeRate:
$ref: '#/components/schemas/OB_Rate1_1'
FeeRateType:
$ref: >-
#/components/schemas/OB_InterestRateType1Code_1
ApplicationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_2
CalculationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_3
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the fee/charge details.
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
$ref: >-
#/components/schemas/OB_OtherFeeChargeDetailType
OtherFeeRateType:
$ref: '#/components/schemas/OB_OtherCodeType1_8'
OtherApplicationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_6'
OtherCalculationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_7'
minItems: 1
RepaymentFeeChargeCap:
type: array
items:
type: object
description: >-
RepaymentFeeChargeCap sets daily, weekly,
monthly, yearly limits on the fees that are
charged
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FEPF
- FTOT
- FYAF
- FYAM
- FYAQ
- FYCP
- FYDB
- FYMI
- FYXX
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_1'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_4'
CappingPeriod:
$ref: '#/components/schemas/OB_Period1Code'
Notes:
type: array
items:
description: >-
Free text for adding extra details for
fee charge cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
RepaymentHoliday:
type: array
items:
type: object
description: Details of capital repayment holiday if any
properties:
MaxHolidayLength:
description: >-
The maximum length/duration of a Repayment
Holiday
type: integer
MaxHolidayPeriod:
description: >-
The unit of period (days, weeks, months
etc.) of the repayment holiday
type: string
enum:
- PACT
- PDAY
- PHYR
- PMTH
- PQTR
- PWEK
- PYER
Notes:
type: array
items:
description: >-
Free text for adding details for repayment
holiday
type: string
minLength: 1
maxLength: 2000
OtherFeesCharges:
type: array
items:
type: object
description: >-
Contains details of fees and charges which are not
associated with either Overdraft or
features/benefits
required:
- FeeChargeDetail
properties:
TariffType:
description: TariffType which defines the fee and charges.
type: string
enum:
- TTEL
- TTMX
- TTOT
TariffName:
description: Name of the tariff
type: string
minLength: 1
maxLength: 350
OtherTariffType:
type: object
required:
- Name
- Description
description: >-
Other tariff type which is not in the standard
list.
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
FeeChargeDetail:
type: array
items:
type: object
description: Other fees/charges details
required:
- FeeCategory
- FeeType
- ApplicationFrequency
properties:
FeeCategory:
$ref: '#/components/schemas/OB_FeeCategory1Code'
FeeType:
$ref: '#/components/schemas/OB_FeeType1Code'
NegotiableIndicator:
description: >-
Fee/charge which is usually negotiable
rather than a fixed amount
type: boolean
FeeAmount:
$ref: '#/components/schemas/OB_Amount1_3'
FeeRate:
$ref: '#/components/schemas/OB_Rate1_1'
FeeRateType:
$ref: >-
#/components/schemas/OB_InterestRateType1Code_1
ApplicationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_2
CalculationFrequency:
$ref: >-
#/components/schemas/OB_FeeFrequency1Code_3
Notes:
type: array
items:
description: >-
Optional additional notes to supplement
the fee/charge details.
type: string
minLength: 1
maxLength: 2000
FeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (maximum charges)
that apply to a particular or group of
fee/charge
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FEPF
- FTOT
- FYAF
- FYAM
- FYAQ
- FYCP
- FYDB
- FYMI
- FYXX
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_1'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_4'
CappingPeriod:
$ref: '#/components/schemas/OB_Period1Code'
Notes:
type: array
items:
description: >-
Free text for adding extra details for
fee charge cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
OtherFeeCategoryType:
$ref: '#/components/schemas/OB_OtherCodeType1_0'
OtherFeeType:
$ref: >-
#/components/schemas/OB_OtherFeeChargeDetailType
OtherFeeRateType:
$ref: '#/components/schemas/OB_OtherCodeType1_8'
OtherApplicationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_6'
OtherCalculationFrequency:
$ref: '#/components/schemas/OB_OtherCodeType1_7'
FeeApplicableRange:
type: object
description: >-
Range or amounts or rates for which the
fee/charge applies
properties:
MinimumAmount:
description: >-
Minimum Amount on which fee/charge is
applicable (where it is expressed as an
amount)
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
MaximumAmount:
description: >-
Maximum Amount on which fee is
applicable (where it is expressed as an
amount)
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
MinimumRate:
description: >-
Minimum rate on which fee/charge is
applicable(where it is expressed as an
rate)
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
MaximumRate:
description: >-
Maximum rate on which fee/charge is
applicable(where it is expressed as an
rate)
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
minItems: 1
FeeChargeCap:
type: array
items:
type: object
description: >-
Details about any caps (maximum charges) that
apply to a particular or group of fee/charge
required:
- FeeType
- MinMaxType
properties:
FeeType:
type: array
items:
description: Fee/charge type which is being capped
type: string
enum:
- FEPF
- FTOT
- FYAF
- FYAM
- FYAQ
- FYCP
- FYDB
- FYMI
- FYXX
minItems: 1
MinMaxType:
$ref: '#/components/schemas/OB_MinMaxType1Code'
FeeCapOccurrence:
$ref: '#/components/schemas/Number_1'
FeeCapAmount:
$ref: '#/components/schemas/OB_Amount1_4'
CappingPeriod:
$ref: '#/components/schemas/OB_Period1Code'
Notes:
type: array
items:
description: >-
Free text for adding extra details for
fee charge cap
type: string
minLength: 1
maxLength: 2000
OtherFeeType:
type: array
items:
type: object
description: >-
Other fee type code which is not
available in the standard code set
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
BCA:
$ref: '#/components/schemas/OBBCAData1'
PCA:
$ref: '#/components/schemas/OBPCAData1'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadScheduledPayment3:
type: object
required:
- Data
properties:
Data:
type: object
properties:
ScheduledPayment:
type: array
items:
$ref: '#/components/schemas/OBScheduledPayment3'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadStandingOrder6:
type: object
required:
- Data
properties:
Data:
type: object
properties:
StandingOrder:
type: array
items:
$ref: '#/components/schemas/OBStandingOrder6'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadStatement2:
type: object
required:
- Data
properties:
Data:
$ref: '#/components/schemas/OBReadDataStatement2'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBReadTransaction6:
type: object
required:
- Data
properties:
Data:
$ref: '#/components/schemas/OBReadDataTransaction6'
Links:
$ref: '#/components/schemas/Links'
Meta:
$ref: '#/components/schemas/Meta'
additionalProperties: false
OBScheduledPayment3:
type: object
required:
- AccountId
- ScheduledPaymentDateTime
- ScheduledType
- InstructedAmount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
ScheduledPaymentId:
$ref: '#/components/schemas/ScheduledPaymentId'
ScheduledPaymentDateTime:
$ref: '#/components/schemas/ScheduledPaymentDateTime'
ScheduledType:
$ref: '#/components/schemas/OBInternalScheduleType1Code'
Reference:
$ref: '#/components/schemas/Reference'
DebtorReference:
$ref: '#/components/schemas/DebtorReference'
InstructedAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_1'
CreditorAgent:
$ref: >-
#/components/schemas/OBBranchAndFinancialInstitutionIdentification5_1
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount5_1'
additionalProperties: false
OBScheduledPayment3Basic:
type: object
required:
- AccountId
- ScheduledPaymentDateTime
- ScheduledType
- InstructedAmount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
ScheduledPaymentId:
$ref: '#/components/schemas/ScheduledPaymentId'
ScheduledPaymentDateTime:
$ref: '#/components/schemas/ScheduledPaymentDateTime'
ScheduledType:
$ref: '#/components/schemas/OBInternalScheduleType1Code'
Reference:
$ref: '#/components/schemas/Reference'
DebtorReference:
$ref: '#/components/schemas/DebtorReference'
InstructedAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_1'
additionalProperties: false
OBScheduledPayment3Detail:
type: object
required:
- AccountId
- ScheduledPaymentDateTime
- ScheduledType
- InstructedAmount
- CreditorAccount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
ScheduledPaymentId:
$ref: '#/components/schemas/ScheduledPaymentId'
ScheduledPaymentDateTime:
$ref: '#/components/schemas/ScheduledPaymentDateTime'
ScheduledType:
$ref: '#/components/schemas/OBInternalScheduleType1Code'
Reference:
$ref: '#/components/schemas/Reference'
DebtorReference:
$ref: '#/components/schemas/DebtorReference'
InstructedAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_1'
CreditorAgent:
$ref: >-
#/components/schemas/OBBranchAndFinancialInstitutionIdentification5_1
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount5_1'
additionalProperties: false
OBStandingOrder6:
type: object
required:
- AccountId
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
StandingOrderId:
$ref: '#/components/schemas/StandingOrderId'
NextPaymentDateTime:
$ref: '#/components/schemas/NextPaymentDateTime'
LastPaymentDateTime:
$ref: '#/components/schemas/LastPaymentDateTime'
StandingOrderStatusCode:
$ref: '#/components/schemas/ExternalMandateStatus1Code'
FirstPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_2'
NextPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_3'
LastPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_11'
FinalPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_4'
CreditorAgent:
$ref: '#/components/schemas/OBBranchAndFinancialInstitutionIdentification5_1'
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount5_1'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
MandateRelatedInformation:
$ref: '#/components/schemas/OBMandateRelatedInformation1'
RemittanceInformation:
$ref: '#/components/schemas/OBRemittanceInformation2'
additionalProperties: false
OBStandingOrder6Basic:
type: object
required:
- AccountId
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
StandingOrderId:
$ref: '#/components/schemas/StandingOrderId'
NextPaymentDateTime:
$ref: '#/components/schemas/NextPaymentDateTime'
LastPaymentDateTime:
$ref: '#/components/schemas/LastPaymentDateTime'
StandingOrderStatusCode:
$ref: '#/components/schemas/ExternalMandateStatus1Code'
FirstPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_2'
NextPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_3'
LastPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_11'
FinalPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_4'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
MandateRelatedInformation:
$ref: '#/components/schemas/OBMandateRelatedInformation1'
RemittanceInformation:
$ref: '#/components/schemas/OBRemittanceInformation2'
additionalProperties: false
OBStandingOrder6Detail:
type: object
required:
- AccountId
- CreditorAccount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
StandingOrderId:
$ref: '#/components/schemas/StandingOrderId'
NextPaymentDateTime:
$ref: '#/components/schemas/NextPaymentDateTime'
LastPaymentDateTime:
$ref: '#/components/schemas/LastPaymentDateTime'
StandingOrderStatusCode:
$ref: '#/components/schemas/ExternalMandateStatus1Code'
FirstPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_2'
NextPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_3'
LastPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_11'
FinalPaymentAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_4'
CreditorAgent:
$ref: '#/components/schemas/OBBranchAndFinancialInstitutionIdentification5_1'
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount5_1'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
MandateRelatedInformation:
$ref: '#/components/schemas/OBMandateRelatedInformation1'
RemittanceInformation:
$ref: '#/components/schemas/OBRemittanceInformation2'
additionalProperties: false
OBStatement2:
type: object
description: Provides further details on a statement resource.
required:
- AccountId
- Type
- StartDateTime
- EndDateTime
- CreationDateTime
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
StatementId:
$ref: '#/components/schemas/StatementId'
StatementReference:
$ref: '#/components/schemas/StatementReference'
Type:
$ref: '#/components/schemas/OBInternalStatementType1Code'
StartDateTime:
$ref: '#/components/schemas/StartDateTime'
EndDateTime:
$ref: '#/components/schemas/EndDateTime'
CreationDateTime:
$ref: '#/components/schemas/CreationDateTime'
StatementDescription:
type: array
items:
description: >-
Other descriptions that may be available for the statement
resource.
type: string
example: August 2017 Statement
minLength: 1
maxLength: 500
StatementBenefit:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a benefit or reward
amount for the statement resource.
required:
- Type
- Amount
properties:
Type:
$ref: '#/components/schemas/OBInternalStatementBenefitType1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_5'
StatementFee:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a fee for the statement
resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
Description:
$ref: '#/components/schemas/Description_1'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementFeeType1Code'
Rate:
$ref: '#/components/schemas/OBRate1_0'
RateType:
$ref: '#/components/schemas/OBInternalStatementFeeRateType1Code'
Frequency:
$ref: '#/components/schemas/OBInternalStatementFeeFrequency1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_6'
StatementInterest:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic interest
amount related to the statement resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
Description:
$ref: '#/components/schemas/Description_2'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementInterestType1Code'
Rate:
$ref: '#/components/schemas/OBRate1_1'
RateType:
$ref: '#/components/schemas/OBInternalStatementInterestType1Code'
Frequency:
$ref: '#/components/schemas/OBInternalStatementInterestFrequency1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_7'
StatementAmount:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic amount for
the statement resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementAmountType1Code'
Amount:
type: object
required:
- Amount
- Currency
description: Amount of money of the cash balance.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
SubType:
description: >-
The amount in the domestic or base accounting currency.
Default is Base Currency (BCUR) if not specified
type: string
enum:
- BCUR
- LCUR
default: BCUR
LocalAmount:
type: object
required:
- Amount
- Currency
description: >-
Optional component providing the equivalent of Amount in local
currency.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
SubType:
description: >-
The amount in the local market currency for which the
asset is held. Default is Local Currency (LCUR) if not
specified
type: string
enum:
- BCUR
- LCUR
default: LCUR
StatementDateTime:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic date time for
the statement resource.
required:
- DateTime
- Type
properties:
DateTime:
$ref: '#/components/schemas/DateTime'
Type:
$ref: '#/components/schemas/OBInternalStatementDateTimeType1Code'
StatementRate:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic rate related
to the statement resource.
required:
- Rate
- Type
properties:
Rate:
$ref: '#/components/schemas/Rate'
Type:
$ref: '#/components/schemas/OBInternalStatementRateType1Code'
StatementValue:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic number value
related to the statement resource.
required:
- Value
- Type
properties:
Value:
$ref: '#/components/schemas/Value'
Type:
$ref: '#/components/schemas/OBInternalStatementValueType1Code'
TotalValue:
type: object
description: Combined sum of all Amounts in the accounts base currency
required:
- Amount
- Currency
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
additionalProperties: false
OBStatement2Basic:
type: object
description: Provides further details on a statement resource.
required:
- AccountId
- Type
- StartDateTime
- EndDateTime
- CreationDateTime
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
StatementId:
$ref: '#/components/schemas/StatementId'
StatementReference:
$ref: '#/components/schemas/StatementReference'
Type:
$ref: '#/components/schemas/OBInternalStatementType1Code'
StartDateTime:
$ref: '#/components/schemas/StartDateTime'
EndDateTime:
$ref: '#/components/schemas/EndDateTime'
CreationDateTime:
$ref: '#/components/schemas/CreationDateTime'
StatementDescription:
type: array
items:
description: >-
Other descriptions that may be available for the statement
resource.
type: string
minLength: 1
maxLength: 500
StatementBenefit:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a benefit or reward
amount for the statement resource.
required:
- Type
- Amount
properties:
Type:
$ref: '#/components/schemas/OBInternalStatementBenefitType1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_5'
StatementFee:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a fee for the statement
resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
Description:
$ref: '#/components/schemas/Description_1'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementFeeType1Code'
Rate:
$ref: '#/components/schemas/OBRate1_0'
RateType:
$ref: '#/components/schemas/OBInternalStatementFeeRateType1Code'
Frequency:
$ref: '#/components/schemas/OBInternalStatementFeeFrequency1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_6'
StatementInterest:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic interest
amount related to the statement resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
Description:
$ref: '#/components/schemas/Description_2'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementInterestType1Code'
Rate:
$ref: '#/components/schemas/OBRate1_1'
RateType:
$ref: '#/components/schemas/OBInternalStatementInterestType1Code'
Frequency:
$ref: '#/components/schemas/OBInternalStatementInterestFrequency1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_7'
StatementDateTime:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic date time for
the statement resource.
required:
- DateTime
- Type
properties:
DateTime:
$ref: '#/components/schemas/DateTime'
Type:
$ref: '#/components/schemas/OBInternalStatementDateTimeType1Code'
StatementRate:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic rate related
to the statement resource.
required:
- Rate
- Type
properties:
Rate:
$ref: '#/components/schemas/Rate'
Type:
$ref: '#/components/schemas/OBInternalStatementRateType1Code'
StatementValue:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic number value
related to the statement resource.
required:
- Value
- Type
properties:
Value:
$ref: '#/components/schemas/Value'
Type:
$ref: '#/components/schemas/OBInternalStatementValueType1Code'
TotalValue:
type: object
description: Combined sum of all Amounts in the accounts base currency
required:
- Amount
- Currency
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
additionalProperties: false
OBStatement2Detail:
type: object
description: Provides further details on a statement resource.
required:
- AccountId
- Type
- StartDateTime
- EndDateTime
- CreationDateTime
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
StatementId:
$ref: '#/components/schemas/StatementId'
StatementReference:
$ref: '#/components/schemas/StatementReference'
Type:
$ref: '#/components/schemas/OBInternalStatementType1Code'
StartDateTime:
$ref: '#/components/schemas/StartDateTime'
EndDateTime:
$ref: '#/components/schemas/EndDateTime'
CreationDateTime:
$ref: '#/components/schemas/CreationDateTime'
StatementDescription:
type: array
items:
description: >-
Other descriptions that may be available for the statement
resource.
type: string
minLength: 1
maxLength: 500
StatementBenefit:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a benefit or reward
amount for the statement resource.
required:
- Type
- Amount
properties:
Type:
$ref: '#/components/schemas/OBInternalStatementBenefitType1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_5'
StatementFee:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a fee for the statement
resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
Description:
$ref: '#/components/schemas/Description_1'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementFeeType1Code'
Rate:
$ref: '#/components/schemas/OBRate1_0'
RateType:
$ref: '#/components/schemas/OBInternalStatementFeeRateType1Code'
Frequency:
$ref: '#/components/schemas/OBInternalStatementFeeFrequency1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_6'
StatementInterest:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic interest
amount related to the statement resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
Description:
$ref: '#/components/schemas/Description_2'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementInterestType1Code'
Rate:
$ref: '#/components/schemas/OBRate1_1'
RateType:
$ref: '#/components/schemas/OBInternalStatementInterestType1Code'
Frequency:
$ref: '#/components/schemas/OBInternalStatementInterestFrequency1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_7'
StatementAmount:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic amount for
the statement resource.
required:
- CreditDebitIndicator
- Type
- Amount
properties:
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_0'
Type:
$ref: '#/components/schemas/OBInternalStatementAmountType1Code'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_8'
LocalAmount:
type: object
required:
- Amount
- Currency
description: >-
Optional component providing the equivalent of Amount in local
currency.
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
SubType:
description: >-
The amount in the local market currency for which the
asset is held. Default is Local Currency (LCUR) if not
specified
type: string
enum:
- BCUR
- LCUR
default: LCUR
StatementDateTime:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic date time for
the statement resource.
required:
- DateTime
- Type
properties:
DateTime:
$ref: '#/components/schemas/DateTime'
Type:
$ref: '#/components/schemas/OBInternalStatementDateTimeType1Code'
StatementRate:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic rate related
to the statement resource.
required:
- Rate
- Type
properties:
Rate:
$ref: '#/components/schemas/Rate'
Type:
$ref: '#/components/schemas/OBInternalStatementRateType1Code'
StatementValue:
type: array
items:
type: object
description: >-
Set of elements used to provide details of a generic number value
related to the statement resource.
required:
- Value
- Type
properties:
Value:
$ref: '#/components/schemas/Value'
Type:
$ref: '#/components/schemas/OBInternalStatementValueType1Code'
TotalValue:
type: object
description: Combined sum of all Amounts in the accounts base currency
required:
- Amount
- Currency
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
additionalProperties: false
OBStatusReason:
type: object
properties:
StatusReasonCode:
type: string
description: |-
Specifies the status reason in a code form.
For a full description see `OBExternalStatusReason1Code` [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
minLength: 1
maxLength: 4
example: U004
StatusReasonDescription:
description: Description supporting the StatusReasonCode.
type: string
minLength: 1
maxLength: 500
example: Permissions field is missing
Path:
type: string
description: >-
Recommended but optional reference to JSON path if relevant to the
StatusReasonCode.
minLength: 1
maxLength: 500
example: Data.Permissions
OBSupplementaryData1:
type: object
properties: {}
additionalProperties: true
description: >-
Additional information that can not be captured in the structured fields
and/or any other specific block.
OBTransaction6:
type: object
description: Provides further details on an entry in the report.
required:
- AccountId
- CreditDebitIndicator
- Status
- BookingDateTime
- Amount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
TransactionId:
$ref: '#/components/schemas/TransactionId'
TransactionReference:
$ref: '#/components/schemas/TransactionReference'
StatementReference:
type: array
items:
$ref: '#/components/schemas/StatementReference'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_1'
Status:
$ref: '#/components/schemas/ExternalEntryStatus1Code'
TransactionMutability:
$ref: '#/components/schemas/OBInternalTransactionMutability1Code'
BookingDateTime:
$ref: '#/components/schemas/BookingDateTime'
ValueDateTime:
$ref: '#/components/schemas/ValueDateTime'
TransactionInformation:
$ref: '#/components/schemas/TransactionInformation'
AddressLine:
$ref: '#/components/schemas/AddressLine'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_9'
ChargeAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_10'
CurrencyExchange:
$ref: '#/components/schemas/OBCurrencyExchange5'
BankTransactionCode:
$ref: '#/components/schemas/OBBankTransactionCodeStructure1'
ProprietaryBankTransactionCode:
$ref: '#/components/schemas/ProprietaryBankTransactionCodeStructure1'
ExtendedProprietaryBankTransactionCodes:
type: array
items:
$ref: '#/components/schemas/OBExtendedProprietaryBankTransactionCode'
Balance:
$ref: '#/components/schemas/OBTransactionCashBalance'
MerchantDetails:
$ref: '#/components/schemas/OBMerchantDetails1'
CreditorAgent:
$ref: '#/components/schemas/OBBranchAndFinancialInstitutionIdentification6_1'
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount6_0'
DebtorAgent:
$ref: '#/components/schemas/OBBranchAndFinancialInstitutionIdentification6_2'
DebtorAccount:
$ref: '#/components/schemas/OBCashAccount6_1'
CardInstrument:
$ref: '#/components/schemas/OBTransactionCardInstrument1'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
CategoryPurposeCode:
$ref: '#/components/schemas/ExternalCategoryPurpose1Code'
PaymentPurposeCode:
$ref: '#/components/schemas/OBExternalPurpose1Code'
UltimateCreditor:
$ref: '#/components/schemas/OBUltimateCreditor1'
UltimateDebtor:
$ref: '#/components/schemas/OBUltimateDebtor1'
additionalProperties: false
OBTransaction6Basic:
type: object
description: Provides further details on an entry in the report.
required:
- AccountId
- CreditDebitIndicator
- Status
- BookingDateTime
- Amount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
TransactionId:
$ref: '#/components/schemas/TransactionId'
TransactionReference:
$ref: '#/components/schemas/TransactionReference'
StatementReference:
type: array
items:
$ref: '#/components/schemas/StatementReference'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_1'
Status:
$ref: '#/components/schemas/ExternalEntryStatus1Code'
TransactionMutability:
$ref: '#/components/schemas/OBInternalTransactionMutability1Code'
BookingDateTime:
$ref: '#/components/schemas/BookingDateTime'
ValueDateTime:
$ref: '#/components/schemas/ValueDateTime'
AddressLine:
$ref: '#/components/schemas/AddressLine'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_9'
ChargeAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_10'
CurrencyExchange:
$ref: '#/components/schemas/OBCurrencyExchange5'
BankTransactionCode:
$ref: '#/components/schemas/OBBankTransactionCodeStructure1'
ProprietaryBankTransactionCode:
$ref: '#/components/schemas/ProprietaryBankTransactionCodeStructure1'
ExtendedProprietaryBankTransactionCodes:
type: array
items:
$ref: '#/components/schemas/OBExtendedProprietaryBankTransactionCode'
CardInstrument:
$ref: '#/components/schemas/OBTransactionCardInstrument1'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
CategoryPurposeCode:
$ref: '#/components/schemas/ExternalCategoryPurpose1Code'
PaymentPurposeCode:
$ref: '#/components/schemas/OBExternalPurpose1Code'
additionalProperties: false
OBTransaction6Detail:
type: object
description: Provides further details on an entry in the report.
required:
- AccountId
- CreditDebitIndicator
- Status
- BookingDateTime
- Amount
properties:
AccountId:
$ref: '#/components/schemas/AccountId'
TransactionId:
$ref: '#/components/schemas/TransactionId'
TransactionReference:
$ref: '#/components/schemas/TransactionReference'
StatementReference:
type: array
items:
$ref: '#/components/schemas/StatementReference'
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_1'
Status:
$ref: '#/components/schemas/ExternalEntryStatus1Code'
TransactionMutability:
$ref: '#/components/schemas/OBInternalTransactionMutability1Code'
BookingDateTime:
$ref: '#/components/schemas/BookingDateTime'
ValueDateTime:
$ref: '#/components/schemas/ValueDateTime'
TransactionInformation:
$ref: '#/components/schemas/TransactionInformation'
AddressLine:
$ref: '#/components/schemas/AddressLine'
Amount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_9'
ChargeAmount:
$ref: '#/components/schemas/OBActiveOrHistoricCurrencyAndAmount_10'
CurrencyExchange:
$ref: '#/components/schemas/OBCurrencyExchange5'
BankTransactionCode:
$ref: '#/components/schemas/OBBankTransactionCodeStructure1'
ProprietaryBankTransactionCode:
$ref: '#/components/schemas/ProprietaryBankTransactionCodeStructure1'
ExtendedProprietaryBankTransactionCodes:
type: array
items:
$ref: '#/components/schemas/OBExtendedProprietaryBankTransactionCode'
Balance:
$ref: '#/components/schemas/OBTransactionCashBalance'
MerchantDetails:
$ref: '#/components/schemas/OBMerchantDetails1'
CreditorAgent:
$ref: '#/components/schemas/OBBranchAndFinancialInstitutionIdentification6_1'
CreditorAccount:
$ref: '#/components/schemas/OBCashAccount6_0'
DebtorAgent:
$ref: '#/components/schemas/OBBranchAndFinancialInstitutionIdentification6_2'
DebtorAccount:
$ref: '#/components/schemas/OBCashAccount6_1'
CardInstrument:
$ref: '#/components/schemas/OBTransactionCardInstrument1'
SupplementaryData:
$ref: '#/components/schemas/OBSupplementaryData1'
CategoryPurposeCode:
$ref: '#/components/schemas/ExternalCategoryPurpose1Code'
PaymentPurposeCode:
$ref: '#/components/schemas/OBExternalPurpose1Code'
UltimateCreditor:
$ref: '#/components/schemas/OBUltimateCreditor1'
UltimateDebtor:
$ref: '#/components/schemas/OBUltimateDebtor1'
additionalProperties: false
OBTransactionCardInstrument1:
type: object
required:
- CardSchemeName
description: |-
Set of elements to describe the card instrument used in the transaction.
For a full list of enumeration values refer to `OBInternalCardSchemeType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
properties:
CardSchemeName:
description: |-
Name of the card scheme.
For a full list of enumeration values refer to `OBInternalCardSchemeType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- AmericanExpress
- Diners
- Discover
- MasterCard
- VISA
AuthorisationType:
description: |-
The card authorisation type.
For a full list of enumeration values refer to `OBInternalCardAuthorisationType1Code` in *OB_Internal_CodeSet* [here](https://github.com/OpenBankingUK/External_Internal_CodeSets)
type: string
enum:
- ConsumerDevice
- Contactless
- None
- PIN
Name:
description: Name of the cardholder using the card instrument.
type: string
minLength: 1
maxLength: 70
Identification:
description: >-
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.
type: string
minLength: 1
maxLength: 34
additionalProperties: false
OBTransactionCashBalance:
type: object
required:
- CreditDebitIndicator
- Type
- Amount
description: >-
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.
properties:
CreditDebitIndicator:
$ref: '#/components/schemas/OBCreditDebitCode_2'
Type:
$ref: '#/components/schemas/OBBalanceType1Code'
Amount:
type: object
required:
- Amount
- Currency
description: >-
Amount of money of the cash balance after a transaction entry is
applied to the account..
properties:
Amount:
$ref: '#/components/schemas/OBActiveCurrencyAndAmount_SimpleType'
Currency:
$ref: '#/components/schemas/ActiveOrHistoricCurrencyCode_1'
additionalProperties: false
OBRisk2:
type: object
additionalProperties: false
properties: {}
description: |-
The Risk section is sent by the initiating party to the ASPSP.
It is used to specify additional details for risk scoring for Account Info.
OB_Amount1_0:
description: Cap amount charged for a fee/charge
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
OB_Amount1_1:
description: >-
Every additional tranche of an overdraft balance to which an overdraft
fee is applied
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
OB_Amount1_2:
description: >-
Amount charged for an overdraft fee/charge (where it is charged in terms
of an amount rather than a rate)
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
OB_Amount1_3:
description: >-
Fee Amount charged for a fee/charge (where it is charged in terms of an
amount rather than a rate)
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
OB_Amount1_4:
description: >-
Cap amount charged for a fee/charge (where it is charged in terms of an
amount rather than a rate)
type: string
pattern: ^(-?\d{1,14}){1}(\.\d{1,4}){0,1}$
OB_CodeMnemonic:
description: The four letter Mnemonic used within an XML file to identify a code
type: string
pattern: ^\\w{0,4}$
OB_FeeCategory1Code:
description: Categorisation of fees and charges into standard categories.
type: string
enum:
- FCOT
- FCRE
- FCSV
OB_FeeFrequency1Code_0:
description: Frequency at which the overdraft charge is applied to the account
type: string
enum:
- FEAC
- FEAO
- FECP
- FEDA
- FEHO
- FEI
- FEMO
- FEOA
- FEOT
- FEPC
- FEPH
- FEPO
- FEPS
- FEPT
- FEPTA
- FEPTP
- FEQU
- FESM
- FEST
- FEWE
- FEYE
OB_FeeFrequency1Code_1:
description: How often is the overdraft fee/charge calculated for the account.
type: string
enum:
- FEAC
- FEAO
- FECP
- FEDA
- FEHO
- FEI
- FEMO
- FEOA
- FEOT
- FEPC
- FEPH
- FEPO
- FEPS
- FEPT
- FEPTA
- FEPTP
- FEQU
- FESM
- FEST
- FEWE
- FEYE
OB_FeeFrequency1Code_2:
description: How frequently the fee/charge is applied to the account
type: string
enum:
- FEAC
- FEAO
- FECP
- FEDA
- FEHO
- FEI
- FEMO
- FEOA
- FEOT
- FEPC
- FEPH
- FEPO
- FEPS
- FEPT
- FEPTA
- FEPTP
- FEQU
- FESM
- FEST
- FEWE
- FEYE
OB_FeeFrequency1Code_3:
description: How frequently the fee/charge is calculated
type: string
enum:
- FEAC
- FEAO
- FECP
- FEDA
- FEHO
- FEI
- FEMO
- FEOA
- FEOT
- FEPC
- FEPH
- FEPO
- FEPS
- FEPT
- FEPTA
- FEPTP
- FEQU
- FESM
- FEST
- FEWE
- FEYE
OB_FeeFrequency1Code_4:
description: Period e.g. day, week, month etc. for which the fee/charge is capped
type: string
enum:
- FEAC
- FEAO
- FECP
- FEDA
- FEHO
- FEI
- FEMO
- FEOA
- FEOT
- FEPC
- FEPH
- FEPO
- FEPS
- FEPT
- FEPTA
- FEPTP
- FEQU
- FESM
- FEST
- FEWE
- FEYE
OB_FeeType1Code:
description: Fee/Charge Type
type: string
enum:
- FEPF
- FTOT
- FYAF
- FYAM
- FYAQ
- FYCP
- FYDB
- FYMI
- FYXX
OB_InterestCalculationMethod1Code:
description: Methods of calculating interest
type: string
enum:
- ITCO
- ITOT
- ITSI
OB_InterestFixedVariableType1Code:
description: Type of interest rate, Fixed or Variable
type: string
enum:
- INFI
- INVA
OB_InterestRateType1Code_0:
description: >-
Rate type for overdraft fee/charge (where it is charged in terms of a
rate rather than an amount)
type: string
enum:
- INBB
- INFR
- INGR
- INLR
- INNE
- INOT
OB_InterestRateType1Code_1:
description: >-
Rate type for Fee/Charge (where it is charged in terms of a rate rather
than an amount)
type: string
enum:
- INBB
- INFR
- INGR
- INLR
- INNE
- INOT
OB_MinMaxType1Code:
description: Min Max type
type: string
enum:
- FMMN
- FMMX
OB_OtherCodeType1_0:
type: object
required:
- Name
- Description
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_1:
type: object
required:
- Name
- Description
description: >-
Other application frequencies that are not available in the standard
code list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_2:
type: object
required:
- Name
- Description
description: >-
Other calculation frequency which is not available in the standard code
set.
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_3:
type: object
required:
- Name
- Description
description: Other Fee type which is not available in the standard code set
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_4:
type: object
required:
- Name
- Description
description: Other fee rate type code which is not available in the standard code set
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_5:
type: object
required:
- Name
- Description
description: Other fee rate type which is not in the standard rate type list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_6:
type: object
required:
- Name
- Description
description: Other application frequencies not covered in the standard code list
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_7:
type: object
required:
- Name
- Description
description: Other calculation frequency which is not available in standard code set.
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherCodeType1_8:
type: object
required:
- Name
- Description
description: Other fee rate type which is not available in the standard code set
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OtherFeeChargeDetailType:
type: object
required:
- FeeCategory
- Name
- Description
description: Other Fee/charge type which is not available in the standard code set
properties:
Code:
$ref: '#/components/schemas/OB_CodeMnemonic'
FeeCategory:
$ref: '#/components/schemas/OB_FeeCategory1Code'
Name:
$ref: '#/components/schemas/Name_4'
Description:
$ref: '#/components/schemas/Description_3'
additionalProperties: false
OB_OverdraftFeeType1Code:
description: Overdraft fee type
type: string
enum:
- FBAO
- FBAR
- FBEB
- FBIT
- FBOR
- FBOS
- FBSC
- FBTO
- FBUB
- FBUT
- FTOT
- FTUT
OB_Period1Code:
description: Period e.g. day, week, month etc. for which the fee/charge is capped
type: string
enum:
- PACT
- PDAY
- PHYR
- PMTH
- PQTR
- PWEK
- PYER
OB_Rate1_0:
description: >-
Rate charged for overdraft fee/charge (where it is charged in terms of a
rate rather than an amount)
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
OB_Rate1_1:
description: >-
Rate charged for Fee/Charge (where it is charged in terms of a rate
rather than an amount)
type: string
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
OpeningDate:
description: >-
Date on which the account and related basic services are effectively
operational for the account owner. All dates in the JSON payloads are
represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
PartyId:
description: >-
A unique and immutable identifier used to identify the customer
resource. This identifier has no meaning to the account owner.
type: string
example: PXSIF023
minLength: 1
maxLength: 40
PartyNumber:
description: Number assigned by an agent to identify its customer.
type: string
example: '20202002'
minLength: 1
maxLength: 35
PhoneNumber_0:
description: >-
Collection of information that identifies a phone number, as defined by
telecom services.
example: '+442079460000'
type: string
pattern: \+[0-9]{1,3}-[0-9()+\-]{1,30}
PhoneNumber_1:
description: >-
Collection of information that identifies a mobile phone number, as
defined by telecom services.
type: string
example: '+447700900000'
pattern: \+[0-9]{1,3}-[0-9()+\-]{1,30}
PostBox:
description: >-
Information that locates and identifies a box in a post office assigned
to a person or organization, where letters for them are kept until
called for.
type: string
example: PO Box 123456
minLength: 1
maxLength: 16
PostCode:
description: >-
Identifier consisting of a group of letters and/or numbers that is added
to a postal address to assist the sorting of mail.
type: string
example: EC2N 4AG
minLength: 1
maxLength: 16
PreviousPaymentDateTime:
description: >-
Date of most recent direct debit collection. All dates in the JSON
payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
ProprietaryBankTransactionCodeStructure1:
type: object
required:
- Code
description: Set of elements to fully identify a proprietary bank transaction code.
properties:
Code:
description: >-
Proprietary bank transaction code to identify the underlying
transaction.
type: string
minLength: 1
maxLength: 35
Issuer:
description: >-
Identification of the issuer of the proprietary bank transaction
code.
type: string
minLength: 1
maxLength: 35
additionalProperties: false
Rate:
description: Rate associated with the statement rate type.
type: string
example: '0.224'
maxLength: 40
pattern: ^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$
Reference:
description: >-
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.
type: string
example: Towbar Club
minLength: 1
maxLength: 35
Room:
description: >-
Information that locates and identifies a room to form part of an
address
type: string
example: Basement 03
minLength: 1
maxLength: 70
OBExtendedProprietaryBankTransactionCode:
type: object
description: >-
Additional proprietary bank transaction codes used by the ASPSP for the
underlying transaction
required:
- Code
properties:
Code:
type: string
description: >-
Proprietary bank transaction code to identify the underlying
transaction.
minLength: 1
maxLength: 35
Issuer:
type: string
description: >-
Identification of the issuer of the proprietary bank transaction
code.
minLength: 1
maxLength: 35
Description:
type: string
description: Description of the code and its usage on the ASPSP channel
minLength: 1
maxLength: 500
OBInternalBeneficiaryType1Code:
description: Specifies the Beneficiary Type.
type: string
example: Ordinary
enum:
- Trusted
- Ordinary
ScheduledPaymentDateTime:
description: >-
The date on which the scheduled payment will be made. All dates in the
JSON payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
example: '2017-07-12T00:00:00+00:00'
format: date-time
ScheduledPaymentId:
description: >-
A unique and immutable identifier used to identify the scheduled payment
resource. This identifier has no meaning to the account owner.
type: string
example: SP03
minLength: 1
maxLength: 40
SecondaryIdentification:
description: >-
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).
type: string
example: '87562298675897'
minLength: 1
maxLength: 34
StandingOrderId:
description: >-
A unique and immutable identifier used to identify the standing order
resource. This identifier has no meaning to the account owner.
type: string
example: Ben5
minLength: 1
maxLength: 40
StartDateTime:
description: >-
Date and time at which the statement period starts. All dates in the JSON
payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
example: '2017-07-12T00:00:00+00:00'
format: date-time
StatementFrequencyAndFormat:
type: array
items:
type: object
description: Frequency and format of statments for an account
properties:
Frequency:
$ref: '#/components/schemas/OBFrequency2'
CommunicationMethod:
$ref: '#/components/schemas/OBCommunicationMethod'
Format:
$ref: '#/components/schemas/OBFileFormat'
DeliveryAddress:
$ref: '#/components/schemas/OBPostalAddress7'
StatementId:
description: >-
Unique identifier for the statement resource within an servicing
institution. This identifier is both unique and immutable.
type: string
example: 8sfhke-sifhkeuf-97813
minLength: 1
maxLength: 40
StatementReference:
description: >-
Unique reference for the statement. This reference may be optionally
populated if available.
type: string
example: '002'
minLength: 1
maxLength: 35
StatusUpdateDateTime:
description: >-
Date and time at which the resource status was updated. All dates in the
JSON payloads are represented in ISO 8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
StreetName:
description: Name of a street or thoroughfare.
type: string
example: Bank Street
minLength: 1
maxLength: 140
Time:
description: >-
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. All dates in the JSON payloads are represented in ISO
8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
T10:43:07+00:00
type: string
format: time
TownName:
description: >-
Name of a built-up area, with defined boundaries, and a local
government.
type: string
example: London
minLength: 1
maxLength: 140
TransactionId:
description: >-
Unique identifier for the transaction within an servicing institution.
This identifier is both unique and immutable.
type: string
minLength: 1
maxLength: 210
TransactionInformation:
description: |-
Further details of the transaction.
This is the transaction narrative, which is unstructured text.
type: string
minLength: 1
maxLength: 500
TransactionReference:
description: >-
Unique reference for the transaction. This reference is optionally
populated, and may as an example be the FPID in the Faster Payments
context.
type: string
minLength: 1
maxLength: 210
UnitNumber:
description: Number that identifies the unit of a specific address .
type: string
example: A88
minLength: 1
maxLength: 16
Value:
description: Value associated with the statement value type.
type: string
minLength: 1
maxLength: 40
ValueDateTime:
description: >-
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. All dates in the JSON payloads are represented in ISO
8601 date-time format.
All date-time fields in responses must include the timezone. An example
is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Model:
type: object
properties:
id:
type: integer
format: int64