/ics/v3/verify/accounts

get

https://sandbox.neonomics.io/ics/v3/verify/accounts

Account Verification endpoint that returns a list of verified accounts for a PSU. A verified account is an IBAN, BBAN and ownerName association for a PSU within a specific bank. This API will return a 1426 error if consent is required. API consumption is allowed only 4 times maximum in a day as per compliance.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

withBalance

boolean

Defaults to false

Set this to also receive the available balance and currency for the verified accounts

scope

string

enum

Defaults to accounts

Request scope.

accounts: to be used for retail accounts
business-accounts: to be used for business and corporate accounts

Allowed:

consent-duration

integer

≥ 1

Defaults to 259200

The duration of the consent in minutes.

Headers

Authorization

string

Authentication scheme used to transmit the access token. Valid value is "Bearer {access token}".

x-session-id

string

required

The session Id returned in the response body when this session was created.

x-device-id

string

required

String that uniquely identifies a single end-user or device.

x-psu-ip-address

string

required

The IP Address of the end-user (PSU), which must be provided if the PSU actively requests information. If this value is not provided, then the call will count towards the number of TPP calls without PSU interaction. Leave it empty if the end user is not actively requesting account information, such as during automatic background updates. Provided in either IPv4 or IPv6 format.

x-psu-id

string

Identifier of the end-user, passed as the base64-encoded value of an encrypted string following the guidelines given in Documentation > Development > Sensitive end-user data. This parameter is required if the value of 'personalIdentificationRequired' returned from the /banks endpoint is "true".

x-originating-host

string

The host where the request is originating from. If you are using end to end encryption from our developer portal then this header is mandatory.

x-originating-date

string

The request originating date. If you are using end to end encryption from our developer portal then this header is mandatory.

Signature

string

The signature header consisting of the signature string If you are using end to end encryption from our developer portal then this header is mandatory.

Responses

200OK

510Returned when the request is invalid due to client-side issues, such as missing or incorrect parameters. Check your request and refer to the Client Error Codes for details.

520Indicates a problem within the Neonomics platform. This error is not caused by your request. See Neonomics Error Codes for troubleshooting steps.

530Returned when the bank encounters an error processing your request. Review the Bank Error Codes for more information and possible solutions.