Account and Transaction API Specification - UK

nbg · Government

Government No Auth Free & Open financial

## Functionality at a glance The NBG "UK OPB - Account and Transaction v3.1.5" API follows the [UK Open Banking Specification v3.1.5](https://openbankinguk.github.io/read-write-api-site3/v3.1.5/profiles/account-and-transaction-api-profile.html) This Account and Transaction API Specification describes the flows and payloads for retrieving a list of accounts and their transactions. The API endpoints described here allow a AISP to: * Create the Consent with the appropriate permis

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Get Accounts

Get Accounts

https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

sandbox-id

example

curl -X GET "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts" \
  -H "sandbox-id: example"

import requests
headers = {
    "sandbox-id": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts';

const response = await fetch(url, {
  headers: {
    'sandbox-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/nbg.gr/v3.1.5/accounts"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("sandbox-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/nbg.gr/v3.1.5/accounts")

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

req = Net::HTTP::Get.new(uri)
req["sandbox-id"] = "example"

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

<?php
$url = "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "sandbox-id: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get Party

Get Party

https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/party

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

sandbox-id

example

curl -X GET "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/party" \
  -H "sandbox-id: example"

import requests
headers = {
    "sandbox-id": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/party",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/party';

const response = await fetch(url, {
  headers: {
    'sandbox-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/nbg.gr/v3.1.5/party"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("sandbox-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/nbg.gr/v3.1.5/party")

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

req = Net::HTTP::Get.new(uri)
req["sandbox-id"] = "example"

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

<?php
$url = "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/party";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "sandbox-id: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get Statements

Get Statements by Account ID

https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts/{accountId}/statements?toStatementDateTime=example&fromStatementDateTime=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

sandbox-id

example

curl -X GET "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts/{accountId}/statements?toStatementDateTime=example&fromStatementDateTime=example" \
  -H "sandbox-id: example"

import requests
params = {
    "toStatementDateTime": "example",
    "fromStatementDateTime": "example"
}
headers = {
    "sandbox-id": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts/{accountId}/statements",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts/{accountId}/statements');
url.searchParams.set('toStatementDateTime', 'example');
url.searchParams.set('fromStatementDateTime', 'example');

const response = await fetch(url, {
  headers: {
    'sandbox-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/nbg.gr/v3.1.5/accounts/{accountId}/statements")
	q := baseURL.Query()
	q.Set("toStatementDateTime", "example")
	q.Set("fromStatementDateTime", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("sandbox-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/nbg.gr/v3.1.5/accounts/{accountId}/statements")
uri.query = URI.encode_www_form({
  "toStatementDateTime" => "example",
  "fromStatementDateTime" => "example"
})

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

req = Net::HTTP::Get.new(uri)
req["sandbox-id"] = "example"

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

<?php
$url = "https://api.apis.guru/v2/specs/nbg.gr/v3.1.5/accounts/{accountId}/statements?" . http_build_query([
    "toStatementDateTime" => "example",
    "fromStatementDateTime" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "sandbox-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 Account and Transaction API Specification - UK?

Account and Transaction API Specification - UK is a Government API. Developers commonly use government APIs for:

surfacing public datasets in citizen-facing apps
building transparency and civic engagement tools
accessing legislation, court records, and official data
powering research and journalism tools
creating compliance and regulatory monitoring dashboards

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Account and Transaction API Specification - UK 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 ↗