Bank Universe API (2.0.0)

Download OpenAPI specification:Download

API to fetch details for

  • Countries
  • Bankgroups which bundle various banks together (e.g. the Sparkassen Group in germany)
  • Banks
  • Integrations which represent the integration towards one or more banks (e.g. different APIs, Portals for Business/Coporate customers, Fallback integrations) which are supported with Klarna Open Banking.

bank-groups

Returns a bank-group

Authorizations:
TokenAuth
Request Body schema: application/json

Payload to fetch a bank-group

country
required
string <ISO 3166-1 alpha-2>

ISO 3166-1 alpha-2 representation of the country

bank_group_krn
required
string <KRN>

The unique klarna resource name of the bank-group

Responses

Request samples

Content type
application/json
{
  • "country": "DE",
  • "bank_group_krn": "krn:openbanking:global:bank-group:b49b66ac-868b-47f0-9587-fd9ae02a9627"
}

Response samples

Content type
application/json
{
  • "bank_group_krn": "krn:openbanking:global:bank-group:b49b66ac-868b-47f0-9587-fd9ae02a9627",
  • "name": "Sparkasse",
  • "country": "DE",
  • "group_selection_recommended": true,
  • "logos": []
}

Returns a list of bank-groups

Authorizations:
TokenAuth
Request Body schema: application/json

Payload to fetch a list of bank-groups

country
required
string <ISO 3166-1 alpha-2>

ISO 3166-1 alpha-2 representation of the country

object (PaginationRequestV2)

Describes a paginated request

Responses

Request samples

Content type
application/json
{
  • "country": "DE",
  • "pagination": {
    }
}

Response samples

Content type
application/json
{
  • "bank_groups": [
    ],
  • "pagination": {
    }
}

banks

Returns a bank

Authorizations:
TokenAuth
Request Body schema: application/json

Payload to fetch a bank with all integrations details

country
required
string <ISO 3166-1 alpha-2>

ISO 3166-1 alpha-2 representation of the country

bank_krn
required
string <KRN>

A unique klarna resource name for the bank

Responses

Request samples

Content type
application/json
{
  • "country": "DE",
  • "bank_krn": "krn:openbanking:global:bank:f15ca33f-cd76-46b8-88f3-403e11bdc710"
}

Response samples

Content type
application/json
{
  • "country": "DE",
  • "bank_krn": "krn:openbanking:global:bank:f15ca33f-cd76-46b8-88f3-403e11bdc710",
  • "name": "Sparkasse Gießen",
  • "group": {
    },
  • "bics": [
    ],
  • "bic_bank_codes": [
    ],
  • "bank_codes": [
    ],
  • "local_routing_numbers": [
    ],
  • "synthetic_bank_codes": [ ],
  • "address": {
    },
  • "popularity": 1000,
  • "integrations": [
    ],
  • "logos": [],
  • "statistics": {
    }
}

Returns a list of supported banks

Authorizations:
TokenAuth
Request Body schema: application/json

Payload to fetch a list of banks

country
required
string <ISO 3166-1 alpha-2>

ISO 3166-1 alpha-2 representation of the country

object (FilterRequestV2)

Object which contains a filter which should be applied.

object (PaginationRequestV2)

Describes a paginated request

Responses

Request samples

Content type
application/json
{
  • "country": "DE",
  • "filter": {
    },
  • "pagination": {
    }
}

Response samples

Content type
application/json
{
  • "banks": [
    ],
  • "pagination": {
    }
}

Returns a list of supported banks for the requested bank data

Authorizations:
TokenAuth
Request Body schema: application/json
iban
string

Search a bank for the given IBAN

bic
string

Search a bank for the given BIC

bank_code
string

Search a bank for the given bank code

country
required
string <ISO 3166-1 alpha-2>

ISO 3166-1 alpha-2 representation of the country

Responses

Request samples

Content type
application/json
{
  • "iban": "DE06000000000023456789",
  • "bic": "DEUTDEBB174",
  • "bank_code": "10070000",
  • "country": "DE"
}

Response samples

Content type
application/json
{
  • "banks": [
    ]
}

countries

Returns a list of supported countries

Authorizations:
TokenAuth

Responses

Response samples

Content type
application/json
{
  • "countries": [
    ]
}

integrations

Fetch all integrations for a country

Authorizations:
TokenAuth
Request Body schema: application/json

Payload to a bank with all integrations details

country
required
string <ISO 3166-1 alpha-2>

ISO 3166-1 alpha-2 representation of the country

object (FilterRequestV2)

Object which contains a filter which should be applied.

object (PaginationRequestV2)

Describes a paginated request

Responses

Request samples

Content type
application/json
{
  • "country": "DE",
  • "filter": {
    },
  • "pagination": {
    }
}

Response samples

Content type
application/json
{
  • "integrations": [
    ],
  • "pagination": {
    }
}