How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Yorkshire Building Society Products API

The Products API from Yorkshire Building Society — 2 operation(s) for products.

Yorkshire Building Society Products API is one of 24 APIs that Yorkshire Building Society publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Product. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 2 operations across 2 paths, and defines 43 schemas. It is described by OpenAPI 3.2.0, at version v3.1.2.

Requests are made against a single base URL, https://ob-ybs.api.ybs.co.uk/open-banking/v3.1/aisp.

2 operations 2 paths 43 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v3.1.2
Base URL
https://ob-ybs.api.ybs.co.uk/open-banking/v3.1/aisp
Authentication
OAuth 2.0, OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 2

Yorkshire Building Society Products API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (TPPOAuth2Security) using the clientCredentials flow, exposing 1 scope. It supports OAuth 2.0 (PSUOAuth2Security) using the authorizationCode flow, exposing 1 scope.

  • TPPOAuth2Security — TPP client credential authorisation flow with the ASPSP
  • PSUOAuth2Security — 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

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Products 2
GET
/accounts/{AccountId}/product
Get Products
GetAccountsAccountIdProduct 5 params → 200400401403404405406429
GET
/products
Get Products
GetProducts 4 params → 200400401403404405406429

Schemas 43

The contract defines 43 schemas that model the data the API accepts and returns. The most detailed are Links (5 properties), OB_OtherFeeChargeDetailType (4 properties), OBError1 (4 properties), OBErrorResponse1 (4 properties). Each schema is shown below with its type and property counts.

OB_OtherCodeType1_4
object
Other fee rate type code which is not available in the standard code set
3 properties 2 required
OB_OtherFeeChargeDetailType
object
Other Fee/charge type which is not available in the standard code set
4 properties 3 required
OB_InterestRateType1Code_0
string
Rate type for overdraft fee/charge (where it is charged in terms of a rate rather than an amount)
OB_Amount1_0
string
Cap amount charged for a fee/charge
Meta
object
Meta Data relevant to the payload
3 properties
OB_Amount1_4
string
Cap amount charged for a fee/charge (where it is charged in terms of an amount rather than a rate)
OB_FeeType1Code
string
Fee/Charge Type
OB_InterestCalculationMethod1Code
string
Methods of calculating interest
OB_FeeFrequency1Code_0
string
Frequency at which the overdraft charge is applied to the account
OB_Rate1_1
string
Rate charged for Fee/Charge (where it is charged in terms of a rate rather than an amount)
OB_Amount1_2
string
Amount charged for an overdraft fee/charge (where it is charged in terms of an amount rather than a rate)
OB_OverdraftFeeType1Code
string
Overdraft fee type
OB_OtherCodeType1_7
object
Other calculation frequency which is not available in standard code set.
3 properties 2 required
OB_OtherCodeType1_3
object
Other Fee type which is not available in the standard code set
3 properties 2 required
OB_Amount1_3
string
Fee Amount charged for a fee/charge (where it is charged in terms of an amount rather than a rate)
OB_OtherCodeType1_5
object
Other fee rate type which is not in the standard rate type list
3 properties 2 required
ISODateTime
string
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:…
OB_Amount1_1
string
Every additional tranche of an overdraft balance to which an overdraft fee is applied
Links
object
Links relevant to the payload
5 properties 1 required
OBErrorResponse1
object
An array of detail error codes, and messages, and URLs to documentation to help remediation.
4 properties 3 required
Name_3
string
Long name associated with the code
OB_OtherCodeType1_8
object
Other fee rate type which is not available in the standard code set
3 properties 2 required
OB_FeeFrequency1Code_4
string
Period e.g. day, week, month etc. for which the fee/charge is capped
OB_OtherCodeType1_1
object
Other application frequencies that are not available in the standard code list
3 properties 2 required
OB_MinMaxType1Code
string
Min Max type
OB_Rate1_0
string
Rate charged for overdraft fee/charge (where it is charged in terms of a rate rather than an amount)
OBSupplementaryData1
object
Additional information that can not be captured in the structured fields and/or any other specific block.
OB_FeeCategory1Code
string
Categorisation of fees and charges into standard categories.
OB_OtherCodeType1_6
object
Other application frequencies not covered in the standard code list
3 properties 2 required
Number_1
integer
fee/charges are captured dependent on the number of occurrences rather than capped at a particular amount
OB_OtherCodeType1_0
object
3 properties 2 required
OB_InterestRateType1Code_1
string
Rate type for Fee/Charge (where it is charged in terms of a rate rather than an amount)
OBError1
object
4 properties 2 required
Description_3
string
Description to describe the purpose of the code
OB_InterestFixedVariableType1Code
string
Type of interest rate, Fixed or Variable
OB_CodeMnemonic
string
The four letter Mnemonic used within an XML file to identify a code
OB_Period1Code
string
Period e.g. day, week, month etc. for which the fee/charge is capped
OB_OtherCodeType1_2
object
Other calculation frequency which is not available in the standard code set.
3 properties 2 required
OBReadProduct2
object
Product details of Other Product which is not avaiable in the standard list
3 properties 1 required
OB_FeeFrequency1Code_3
string
How frequently the fee/charge is calculated
OB_FeeFrequency1Code_2
string
How frequently the fee/charge is applied to the account
OB_FeeFrequency1Code_1
string
How often is the overdraft fee/charge calculated for the account.
Number_0
integer
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…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yorkshire-building-society-products-api-openapi.yml Raw ↑

Other APIs Yorkshire Building Society publishes across the network.

Yorkshire Building Society Dynamic Client Registration API
Yorkshire Building Society Generate Access Token API
Yorkshire Building Society Account Access API
Yorkshire Building Society Accounts API
Yorkshire Building Society Balances API
Yorkshire Building Society Beneficiaries API
Yorkshire Building Society Direct Debits API
Yorkshire Building Society Domestic Payments API
Yorkshire Building Society Domestic Scheduled Payments API
Yorkshire Building Society Domestic Standing Orders API
Yorkshire Building Society Event Subscriptions API
Yorkshire Building Society File Payments API
Where this information came from

This is an independent, third-party profile of Yorkshire Building Society Products API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.