For Agents
Read NBG accounts, balances, transactions, statements, standing orders, and beneficiaries through a UK Open Banking v3.1.5 AISP interface.
Get started with Account and Transaction API Specification - UK in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"list NBG account transactions under an Open Banking consent"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Account and Transaction API Specification - UK API.
Create, retrieve, and revoke account access consents under the UK Open Banking v3.1.5 model
List the customer's NBG accounts and read individual account metadata
Read balances, transactions, and statement detail for a chosen account
Retrieve scheduled payments, standing orders, and beneficiaries on an account
GET STARTED
Use for: Create an account access consent for an NBG customer, List all accounts authorised under a consent, Get the current balances for an NBG account, Retrieve transactions for a specific NBG account and date range
Not supported: Does not handle payment initiation, card issuing, or loan origination — use for UK Open Banking AISP read access to NBG accounts, balances, transactions, statements, and sandbox provisioning only.
Jentic publishes the only available OpenAPI specification for Account and Transaction API Specification - UK, keeping it validated and agent-ready.
The National Bank of Greece Account and Transaction API implements the UK Open Banking Account and Transaction profile v3.1.5, providing AISP-style access to NBG retail and business accounts. Authorised third parties can request consent, list accounts, and read balances, transactions, statements, beneficiaries, parties, scheduled payments, and standing orders. The spec also exposes sandbox management endpoints for setting up and tearing down test datasets. Authentication combines OAuth 2.0 (client-credentials and authorisation-code flows) with a Client-Id header.
Read party data for the account holder and connected parties
Provision, import, export, and delete sandbox datasets for test environments
Patterns agents use Account and Transaction API Specification - UK API for, with concrete tasks.
★ AISP Account Aggregation for NBG Customers
Account information service providers offering personal finance dashboards need a UK Open Banking compliant feed for NBG customer accounts. The API's account, balance, and transaction endpoints, gated by /account-access-consents, return the data required to populate a customer dashboard once consent is granted. The flow follows the UK Open Banking v3.1.5 profile so existing AISP code paths can be reused.
POST /account-access-consents to obtain a consent ID, then call /accounts and /accounts/{accountId}/transactions for each authorised account.
Personal Finance Management Integration
PFM apps and accounting tools that connect to Greek bank accounts read balances and transactions on a regular schedule to keep budgets and spending insights current. /accounts/{accountId}/balances and /accounts/{accountId}/transactions return real-time balance and posted-transaction feeds in the standard UK Open Banking shape. Standing orders and scheduled payments help the PFM forecast upcoming cash flow.
Pull /accounts/{accountId}/balances and /accounts/{accountId}/transactions every 12 hours for each authorised NBG account and update the PFM database.
Statement Retrieval for Lending and Underwriting
Lenders and underwriters use bank statements as primary evidence in affordability and KYC checks. /accounts/{accountId}/statements lists available statements, /accounts/{accountId}/statements/{statementId} returns metadata, and /accounts/{accountId}/statements/{statementId}/file downloads the statement document. Combining the three calls automates statement collection during a loan application.
List statements via /accounts/{accountId}/statements, then for each statement call /accounts/{accountId}/statements/{statementId}/file to download the PDF.
Sandbox Provisioning for AISP Development
Developers integrating with the NBG Open Banking surface need predictable sandbox datasets to test edge cases. /sandbox supports POST to create, PUT to import, GET to export, and DELETE to clear test datasets, allowing CI pipelines to set up and tear down state per test run. This avoids drift from a shared sandbox account.
POST /sandbox with a fresh dataset payload at the start of a test run, then DELETE /sandbox/{sandboxId} once the suite finishes.
Agent-Driven Account Insights via Jentic
Agents that surface bank balances or recent transactions for users need to navigate the Open Banking consent flow and OAuth dance without holding tokens directly. Through Jentic the agent searches by intent, loads the schema for the account or transaction operation, and executes it once consent is established, while Jentic stores the OAuth client credentials and Client-Id header in the vault. The agent never sees raw bank credentials.
Search Jentic for 'list account balances under an Open Banking consent', load the schema for /accounts/{accountId}/balances, and execute it for the user's authorised NBG account.
21 endpoints — the national bank of greece account and transaction api implements the uk open banking account and transaction profile v3.
METHOD
PATH
DESCRIPTION
/account-access-consents
Create an account access consent
/account-access-consents/{consentId}
Retrieve an account access consent
/account-access-consents/{consentId}
Revoke an account access consent
/accounts
List authorised accounts
/accounts/{accountId}/balances
Get balances for an account
/accounts/{accountId}/transactions
List transactions for an account
/accounts/{accountId}/standing-orders
List standing orders on an account
/accounts/{accountId}/statements/{statementId}/file
Download a statement file
/account-access-consents
Create an account access consent
/account-access-consents/{consentId}
Retrieve an account access consent
/account-access-consents/{consentId}
Revoke an account access consent
/accounts
List authorised accounts
/accounts/{accountId}/balances
Get balances for an account
Three things that make agents converge on Jentic-routed access.
Credential isolation
NBG OAuth client credentials, redirect handling, and the Client-Id header value are all stored encrypted in the Jentic vault. Jentic runs the token exchange and attaches the Client-Id header on each AISP request so the agent never sees raw bank or client secrets.
Intent-based discovery
Agents search Jentic by intent (e.g. 'list NBG account transactions under an Open Banking consent') and Jentic returns the matching Account and Transaction operation with its input schema for direct execution.
Time to first call
Direct integration with NBG UK Open Banking: 1-2 weeks for consent flow, OAuth client-credentials and authorisation-code wiring, signed-request handling, and v3.1.5 schema work. Through Jentic: under 1 day — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
TrueLayer Data API
Multi-bank Open Banking aggregator covering UK and EU institutions including alternatives to NBG.
Choose TrueLayer when the workflow needs coverage across many banks rather than NBG specifically.
Plaid API
Bank data aggregator with broad US and EU coverage and a single integration.
Pick Plaid when the agent needs the same aggregator across NBG and non-Open-Banking institutions.
Revolut Open Banking API
Another UK Open Banking compliant bank API used alongside NBG for multi-bank views.
Use Revolut Open Banking when the same dashboard needs Revolut accounts in addition to NBG.
Specific to using Account and Transaction API Specification - UK API through Jentic.
What authentication does the NBG Account and Transaction API use?
The API requires OAuth 2.0 with both client-credentials and authorisation-code flows, plus a Client-Id header on each request. Jentic stores the OAuth client and Client-Id values in its vault and runs the token exchange transparently before the AISP call.
Can I list a customer's accounts and balances with the NBG Open Banking API?
Yes. After establishing a consent via POST /account-access-consents, GET /accounts returns the authorised accounts and GET /accounts/{accountId}/balances returns the current and available balance per account in the UK Open Banking v3.1.5 schema.
What are the rate limits for the NBG Open Banking API?
The OpenAPI spec does not publish numeric rate limits. UK Open Banking guidance limits AISP polling for unattended access to four calls per consent per 24 hours per resource and allows higher rates while the user is present; confirm exact NBG limits in the developer portal at developer.nbg.gr.
How do I read NBG transactions through Jentic?
Run pip install jentic, search for 'list NBG account transactions under an Open Banking consent', load the schema for /accounts/{accountId}/transactions, and execute it once Jentic has handled the consent and OAuth steps. Sign up at https://app.jentic.com/sign-up.
Does this API let me initiate payments?
No. The Account and Transaction surface is read-only AISP. Initiating payments under UK Open Banking PISP requires a separate Payment Initiation API specification, which is not covered by this spec.
Can I provision sandbox data for testing the NBG API?
Yes. POST /sandbox creates a sandbox dataset, PUT /sandbox imports an existing dataset, GET /sandbox/{sandboxId} exports it, and DELETE /sandbox/{sandboxId} removes it. These endpoints let CI pipelines set up reproducible test state per run.
/accounts/{accountId}/transactions
List transactions for an account
/accounts/{accountId}/standing-orders
List standing orders on an account
/accounts/{accountId}/statements/{statementId}/file
Download a statement file