API 2.0 Docs

auth

The API uses Oauth 2.0 spec, to authenticate requests an authorization bearer token is needed first. To get client id and client secret head to https://dash.nordigen.com/api-keys.

Get the auth token

Fetch bearer authorization token.

POST https://api.nordigen.com/oauth/token
REQUEST BODY SCHEMA: application/json
Parameters:

  • audience: string, required
  • client_id: string, required
  • client_secret: string, required
  • grant_type: string, required

Request Example

Response Example


Account Statement Analysis

Nordigen API offers a variety of account statement analysis tools which can be applied

Statement Upload

To process statement accounts they first need to be uploaded. After upload processing record will be created, returning request id in the response. After this it needs to be passed to request operation endpoint in which necessary operations are specified.

POST https://api.nordigen.com/v2/report
REQUEST BODY SCHEMA: multipart/form-data
Parameters:

  • input: file(s) buffer, required

Request Example

Response Example

Apply analysis products to uploaded account data

PUT https://api.nordigen.com/v2/report/process/{request-id} Request samples
REQUEST BODY SCHEMA: application/json
Parameters:

  • country: string, required
  • operations: array of strings, required. Operation keyword is defined for each analysis product in their documentation.
  • params: object, optional. Specifies configuration for analysis products, details will be specified under the respective product documentation
  • use_webhook: boolean, optional. Enables webhook after finishing processing

Request Example

Response Example

Get result

Retrieve requested analysis products result. If processing is not finished when this endpoint is called it will return status processing and it should be requested again until status completed is returned. Once it is completed this endpoint will also return requested products, their responses can be seen in respective product documentation pages.

GET https://api.nordigen.com/v2/report/{request-id}
Parameters:

  • request_id: string, required
Request Example

Response Example

Get available scoring model

This is relevant for credit scoring product, use this request to see what scoring models are available for you.

GET https://api.nordigen.com/v2/available-models

Request Example

      curl -X GET \
      https://api.nordigen.com/v2/available-models \
      -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response Example


Categories

Retrieve the latest category tree

GET https://api.nordigen.com/v2/category-tree/{country}
Parameters:

  • country: string, required. Two letter country code filter for categories
Request Example

Response Example


Webhooks

Setting up webhooks allows receiving status update for processing records once they are completed.

Set up webhooks

POST https://api.nordigen.com/v2/webhook-settings
REQUEST BODY SCHEMA: application/json
Parameters:

  • auth_method: string, optional. Authentication Method to use for webhook, possible options are OAuth2 and Basic Auth
  • auth_password: string, optional. Used for Basic Auth as password
  • auth_username: string, optional. Used for Basic Auth as username
  • callback_url: string, required. URL to which POST webhook request will be sent
  • oauth_audience: string, optional. Used for Oauth2 auth flow as audience when fetching token
  • oauth_client_audience: string. optional. Used for Oauth2 as scope when fetching token
  • oauth_client_id: string, optional. Used for Oauth2 as client id when fetching token
  • oauth_client_secret: string, optional. Used for Oauth2 as client secret when fetching token
  • >oauth_token_url: string, optional. Used for Oauth2 as location from which to fetch token
Request Example

Response Example