These docs are for v2.5. Click to read the latest docs for v3.0.

Bank Connections

We have the following lists of available bank connections:

Every client you create will have access to the test connections by default. Access to the real connections via the API will need to be requested.

Every connection will have the following properties:

  • id - bank connection id (used to request an authorization url for a specific bank)
  • name
  • type - the type of bank connection (api, legacy or test)
  • bankRef - reference that uniquely identifies a set of connections as being part of the same institution (e.g. HSBC Open banking and HSBC credit cards). It is used to group a set of connections by the banking institution they refer to. It can also be used to retrieve the bank icon.
  • parentRef - this property is now deprecated. Please use bankRef instead
  • iconUrl - the url of the bank icon SVG. Please be aware we don’t have icons for all the connections we provide. For the missing icons you can either use your own set or use our generic bank icon found at this url: https://identity.moneyhub.co.uk/bank-icons/default
  • accountTypes - an array containing the types of accounts supported by the connection (cash, card, pension, mortgage, investment, loan) and a beta boolean value flagging which accounts types for that connection are currently being developed and may not have a 100% success rate
  • userTypes - an array of user account types supported by the bank connection (personal and business)
  • payments - an array of payments capabilities for thebank (domestic)
  • status - an object that represents the status for the provider for synchronisations and authorisations. The possible values are: AVAILABLE, PARTIALLY_AVAILABLE, TEMPORARILY_UNAVAILABLE, PERMANENTLY_UNAVAILABLE

Connection types

Different connection types are updated on different schedules - see Connection lifecycle.

Connection typeDescription
apiUses the bank's own API (such as Open Banking) to authenticate and get financial data. Can use native bank apps for authentication, and therefore biometrics.
legacyUses screen-scraping or similar technologies to authenticate and get financial data. This may be via a 3rd party provider API (screen-scraping is handed off, data retrieved via API). User may need to enter their own credentials (no biometrics). Uses web forms for authentication.
testVarious mock/fake banks for use when testing. See Test Banks

Connection Statuses

For a connection status, we give information on the authorisation (auth) and synchronisation (sync) element of the connection.

Sync status will determine the health of existing connections pulling up to date data from the provider. Auth status will explain the health of a user attempting to create a new connection with that provider. The below table explains what each status enumeration means

StatusDescription
AVAILABLEThe connection is fully healthy and users should expect an uninterrupted journey using the provider.
PARTIALLY_AVAILABLEThe connection is not fully healthy, users may be able to carry out their tasks against that provider, but some users may report issues while interacting with that provider.
TEMPORARILY_UNAVAILABLEThe connection would normally be healthy, but is currently experiencing downtime so users will not be able to carry out any task against the provider.
PERMANENTLY_UNAVAILABLEThe provider used to be supported by Moneyhub, but is no longer supported.

GET /bank-icons/:bankRef

https://identity.moneyhub.co.uk/bank-icons/:bankRef

Retrieve the bank icon as SVG when providing a valid bank reference listed under our available connections.
Can also return PNG or JPG images when .png or .jpg file extension is added.

Please be aware we don’t have icons for all the connections we provide, when this is the case the route returns 404 as response unless the defaultIcon parameter is used.

Route ParametersTypeDescription
bankrefbankrefUnique bank reference of the provider. When using default as the bank reference we return a generic bank icon.
Query ParametersTypeDescription
defaultIconBooleanWhen value is true the route will return the default icon instead of 404 if bank icon is not available