Quickstart Guide

This document explains how to jump start your integration with the Account Information API.

Step 1: Get Access Token

First, you'll need to get your token from the Nordigen's Open Banking Portal.


Step 2: Choose a Bank

Use aspsp endpoint to get a list of all avialable ASPSPs (banks) in a given country. You will need to provide access token from Step 1 as YOUR_TOKEN and a two letter coutry code (ISO 3166). ID for the chosen bank will be used in the following steps (referenced as aspsp_id). See also the guide on how to build an end user interface for a selecting a bank.

Response:


Step 3: Create end user agreement

N.B. Use this step only if you want to specify length of transaction history you want to retrieve. If you skip this step, by default 90 days of transaction history will be retrieved.

You need to create an agreement and pass:
- max historical days as length of the transaction history to be retrieved;
- the end user ID (unique ID defined by you) as the UUID;
- aspsp_id from Step 2.

Response:


First, you need to create a requisition which is a collection of inputs for creating links and retrieving accounts. For requisition API requests you will need to provide:
- Access token from Step 1 as YOUR_TOKEN;
- end user ID (unique end user ID defined by you), a reference ID (additional layer of unique ID defined by you). NB If you didn't skip Step 3 end user ID has to match one provided in Step 3;
- redirect link where an end user will be redirected after finishing authentication in ASPSP;
- agreements ID from Step 3 or leave brackets empty if you skipped that step.

N.B. use the same end user ID from Step 3 if it applies to you.

Response:

Second, create a redirect link for the end user to ASPSP. You need to provide aspsp_id from Step 2 (it should match aspsp_id from Step 3 if you did not skip it).

Response:


Step 5: List accounts

Once a user is redirected back to the link provided in Step 4, users' bank accounts can be listed. Pass requisition ID to view accounts.

Response:


Step 6: Access accounts, balances and transactions

There are three seperate endpoints for accessing account details, balances and transactions. See account endpoints to view respective endpoints.

In this quickstart we will showcase transactions endpoint, where you need to pass account ID (see "accounts" from output of Step 5) to access transaction information. Each account needs to be queried separately.

Response:


What's next.

Congratulations - you now can connect to end user bank accounts and access raw account and transaction data. To learn more about the output data structures and see more details behind the keys, please visit accounts and transactions.

Once you’re ready to extract more value from the raw account information, take a look at our premium products - Transaction Categorisation and Insights