Account API

Access account balance and transaction history of a customer in total security.

Error codes

The table below lists the possible exceptions (error scenarios), either caused by your request or by the API.



http status codes

Error

Error-code

Error-description

Scenario

400

MISSING_INPUT

GEN-1201-100001

Missing required header input 'INPUT'

Request received without a mandatory input in the header

 

MISSING_INPUT

GEN-1201-100002

Missing required body/path/query input 'INPUT'

Request received without a mandatory input in the body/path/query

 

INVALID_INPUT

GEN-1202-100001

Invalid request header input.

Request received with bad input (invalid format) values in the header

 

INVALID_INPUT

GEN-1202-100002

Invalid request body/path/query input.

Request received with bad input (invalid format) values in the body/path/query

401

FAILED_SECURITY_VALIDATION

GEN-1203-100003

Invalid access token

Request received with invalid access_token.

 

FAILED_SECURITY_VALIDATION

GEN-1203-100008

Validation failed for security related parameters 

Request sent with invalid security parameter

 

FAILED_SECURITY_VALIDATION

GEN-1203-100009

Invalid Api-Key/Client-ID

Request received with invalid Client-ID or TPP-ID

 

FAILED_SECURITY_VALIDATION

GEN-1203-100010

Invalid JWT

Request received with an incorrect JWT token. This error can be linked to an incorrect logical-ID, an incorrect SCA token or PIS token

 

SCA_REQUIRED

B14800ZZ-0PLC-REDRCT

SCA is required. Please follow the corresponding URL in the response body.

In AIS context, this error can be linked to an SCA that should be renewed (to access the account transaction) or because the PSU wants to access transactions that happend more than 90 days in the past. In PIS context, a SCA should be performed to sign the payment initiation"

403

INVALID_TPP

B14663ZZ-2100-000000

No Active TPP found.

Request received with a Client-ID which is not active

 

INVALID_ACCOUNT

B14800ZZ-3002-000000

No Account found.

Request received with non-Belfius account if Belfius end point is used.
Request received with non-Banx account if Banx end point is used. (Banx will be decommissioned in December 2024)

 

ACCESS_DENIED

B14800ZZ-3004-000000

Access is not ok for this account. Please contact customer support.

Request received with an account for which access has been disabled by provider. Please contact Belfius customer service

 

CHANNEL_NOT_PERMITTED

B14800ZZ-3007-000000

This account can not be consultated via electronical channel.

Request received for an account that is not consultable with electronic channel or request received for a Banx account using the Belfius endpoint or vice versa (Belfius account using Banx endpoints).
(Banx will be decommissioned in December 2024)

 

ACCOUNT_NOT_SUPPORTED

B14800ZZ-3008-000000

This account is not allowed for this type of request.

Request received for an account that is 'not allowed for PSD2'

 

NO_ACTIVE_CONSENT

B14800ZZ-3013-000000

User has deactivated its consent in the channel. Tpp has to start over with /consent-uris flow

Request received with the consent which has been deactivated by the user within its Belfius or Banx channel
(Banx will be decommissioned in December 2024)

 

ACCESS_DENIED

B14800ZZ-3017-000000

Access is not ok for this account.

Request received with an account for which the PSU has no access (e.g. role on the account has changed)

 

NO_ACTIVE_CONSENT

B14765-2100-000000

User did not enroll its account for this scope

 

 

OTHER_API_ERRORS

GEN-1206-100009

No account found with given logicalId.

PSU does not have eligible accounts

404

OTHER_API_ERRORS

GEN-1206-100001

Requested resource was not found.

Request received with unsupported HTTP verb

 

OTHER_API_ERRORS

GEN-1206-100002

Specific version not found. Supported versions are  'INPUT'

Request received with invalid version in Accept header

 

OTHER_API_ERRORS

GEN-1206-100007

No account found with given logicalId.

Request received with invalid logicalId

405

OTHER_API_ERRORS

GEN-1206-100003

Method not allowed

Request received with restricted HTTP verbs

406

OTHER_API_ERRORS

GEN-1206-100006

Server can not return the response In the format mentioned in the request. Supported type is: 'INPUT'

Request received with invalid type in Accept header

429

API_USAGE_LIMIT_REACHED

GEN-1205-100002

Quota limit exceeded

Request received when the TPP have perform more than 4 unattended calls per 24 hours

495

FAILED_SECURITY_VALIDATION

GEN-1203-100001

SSL validation error

SSL certificate error. Mutual TLS can not be established. It may occur when an unregistered client( or a client with an invalid/expired certificate) trying to access a secure api

500

OTHER_API_ERRORS

GEN-1206-100004

Internal error occurred

Internal server error

500

OTHER_API_ERRORS

GEN-1206-100008

Internal error occurred with reason :

Internal error occurred with reason :

503

SERVICE_UNAVAILABLE

GEN-1204-100001

Service is unavailable

Planned down-time in currently on going