Core APIs

Banks

Copy page

The ASPSP Information Service retrieves a list of all ASPSPs (banks and financial institutions) currently supported by the Open Payments platform. This allows your application to display available banks to the PSU before creating consents or initiating payments.

For requests to the ASPSP Information Service API, you need an access token with scope set to aspspinformation corporate.

1. Get ASPSP List

This request allows you to retrieve a list of supported ASPSPs, optionally filterable by country via the isoCountryCodes query parameter.

Endpoint

Code
 
GET /psd2/aspspinformation/v1/aspsps

Query Parameters

Name	Type	Description
isoCountryCodes	array	ISO Country Codes for the countries to get banks for.

Request Headers

Name	Type	Description
X-Request-ID	string(uuid)	The ID of the request, unique to the call, as determined by the initiating party.

Code
 
curl -X GET "https://api.openbankingplatform.com/psd2/aspspinformation/v1/aspsps?isoCountryCodes=SE" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIn0..." \
  -H "X-Request-ID: 0388a0b5-c8e4-4c37-89ae-058b74899170"

Response

Code
 
{
  "aspsps": [
    {
      "bicFi": "ESSESESS",
      "name": "Skandinaviska Enskilda Banken AB",
      "logoUrl": "https://opeopenbanking.blob.core.windows.net/images/ESSESESS.jpg"
    },
    {
      "bicFi": "HANDSESS",
      "name": "Handelsbanken",
      "logoUrl": "https://opeopenbanking.blob.core.windows.net/images/HANDSESS.svg"
    },
    {
      "bicFi": "NDEASESS",
      "name": "Nordea Bank AB",
      "logoUrl": "https://opeopenbanking.blob.core.windows.net/images/NDEASESS.png"
    }
  ]
}        

You now have a list of Swedish banks that you can use to create a UI that let your PSU select a bank to authenticate to.

2. Get ASPSP Details

Next, you can fetch details for a specific bank in the list, such as the bank's supported payment products and authorisation methods.

Endpoint

Code
 
GET /psd2/aspspinformation/v1/aspsps/{bicFi}

Path Parameters

Name	Type	Description
bicFi	string	The BIC of the bank.

Request Headers

Name	Type	Description
X-Request-ID	string(uuid)	The ID of the request, unique to the call, as determined by the initiating party.

Code
 
curl -X GET "https://api.openbankingplatform.com/psd2/aspspinformation/v1/aspsps/ESSESESS" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIn0..." \
  -H "X-Request-ID: f87a6512-7569-4108-8f86-286c3e4c2b79"

Response

Code
 
{
  "bicFi": "ESSESESS",
  "name": "Skandinaviska Enskilda Banken AB",
  "logoUrl": "https://opeopenbanking.blob.core.windows.net/images/ESSESESS.jpg",
  "city": "Stockholm",
  "country": "Sweden",
  "postalCode": "106 40",
  "streetAddress": "Kungsträdgårdsgatan 8",
  "companyNumber": "502032-9081",
  "phone": "+46-771 365 365",
  "websiteUrl": "https://seb.se/",
  "globalPaymentProducts": [
    "sepa-credit-transfers",
    "domestic",
    "cross-border",
    "swedish-giro"
  ],
  "supportedAuthorizationMethods": [
    {
      "name": "OAuth2",
      "uri": "https://auth.openbankingplatform.com/.well-known/openid-configuration"
    },
    {
      "name": "Decoupled",
      "uri": ""
    }
  ]
}