Swiss NextGen Banking API-Framework

openbankingproject · Finance

Finance No Auth Free & Open financial

# Summary The **Swiss NextGen API** is based on the NextGenPSD2 *Framework Version 1.3.4* of the Berlin Group which offers a modern, open, harmonised and interoperable set of Application Programming Interfaces (APIs) as the safest and most efficient way to provide data securely. The NextGen Framework reduces XS2A complexity and costs, addresses the problem of multiple competing standards in Europe and, aligned with the goals of the Euro Retail Payments Board, enables European banking customers t

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Read account list

Read the identifiers of the available payment account together with booking balance information, depending on the consent granted. It is assumed that a consent of the PSU to this access is already given and stored on the ASPSP system. The addressed list of accounts depends then on the PSU ID and t

https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts?withBalance=true

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

Consent-ID	example
X-Request-ID	example

curl -X GET "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts?withBalance=true" \
  -H "Consent-ID: example" \
  -H "X-Request-ID: example"

import requests
params = {
    "withBalance": "true"
}
headers = {
    "Consent-ID": "example",
    "X-Request-ID": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts');
url.searchParams.set('withBalance', 'true');

const response = await fetch(url, {
  headers: {
    'Consent-ID': 'example',
    'X-Request-ID': 'example'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts")
	q := baseURL.Query()
	q.Set("withBalance", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("Consent-ID", "example")
	req.Header.Set("X-Request-ID", "example")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts")
uri.query = URI.encode_www_form({
  "withBalance" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["Consent-ID"] = "example"
req["X-Request-ID"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts?" . http_build_query([
    "withBalance" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "Consent-ID: example",
        "X-Request-ID: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Read account details

Reads details about an account, with balances where required. It is assumed that a consent of the PSU to this access is already given and stored on the ASPSP system. The addressed details of this account depends then on the stored consent addressed by consentId, respectively the OAuth2 access to

https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts/{account-id}?withBalance=true

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

Consent-ID	example
X-Request-ID	example

curl -X GET "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts/{account-id}?withBalance=true" \
  -H "Consent-ID: example" \
  -H "X-Request-ID: example"

import requests
params = {
    "withBalance": "true"
}
headers = {
    "Consent-ID": "example",
    "X-Request-ID": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts/{account-id}",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts/{account-id}');
url.searchParams.set('withBalance', 'true');

const response = await fetch(url, {
  headers: {
    'Consent-ID': 'example',
    'X-Request-ID': 'example'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts/{account-id}")
	q := baseURL.Query()
	q.Set("withBalance", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("Consent-ID", "example")
	req.Header.Set("X-Request-ID", "example")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts/{account-id}")
uri.query = URI.encode_www_form({
  "withBalance" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["Consent-ID"] = "example"
req["X-Request-ID"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/accounts/{account-id}?" . http_build_query([
    "withBalance" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "Consent-ID: example",
        "X-Request-ID: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get consent request

Returns the content of an account information consent object. This is returning the data for the TPP especially in cases, where the consent was directly managed between ASPSP and PSU e.g. in a redirect SCA Approach.

https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/consents/{consentId}

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

X-Request-ID

example

curl -X GET "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/consents/{consentId}" \
  -H "X-Request-ID: example"

import requests
headers = {
    "X-Request-ID": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/consents/{consentId}",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/consents/{consentId}';

const response = await fetch(url, {
  headers: {
    'X-Request-ID': 'example'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/consents/{consentId}"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-Request-ID", "example")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/consents/{consentId}")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["X-Request-ID"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/openbankingproject.ch/1.3.8_2020-12-14 - Swiss edition 1.3.8.1-CH/v1/consents/{consentId}";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-Request-ID: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Swiss NextGen Banking API-Framework?

Swiss NextGen Banking API-Framework is a Finance API. Developers commonly use finance APIs for:

processing payments and handling transactions
building subscription and billing systems
automating invoicing and financial reporting
fraud detection and risk scoring
connecting to banking and accounting software

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Swiss NextGen Banking API-Framework is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗