Errors

In case of an error, Accounts and Transfers services return a response in application/problem+json format. The unified error response fields and service error codes are provided below.

Error response fields

Field	Type	Description
type	string	Error type URI
title	string	Error title
status	integer	HTTP status code
detail	string / null	Additional error description
code	string	Error code
traceId	string	Request identifier used for technical investigation
errors	object / null	Validation error details by specific fields
objectType	string / null	For 404 - object type
objectId	string / null	For 404 - object ID

Accounts Error Codes

HTTP Status	Code	Title	Description
400	ValidationError	INCORRECT_INPUT_DATA	Request parameters are provided incorrectly
400	DomainError	INVALID_ACCOUNT	The specified account and currency could not be found or are not available
400	DomainError	USER_IS_DELETED	The user does not exist or has deleted status
400	DomainError	USER_IS_NOT_ACTIVE	User is not active
400	DomainError	USER_IS_BLOCKED	User is blocked
403	ForbiddenError	NOT_AUTHORIZED	The user does not have the relevant operation permission in Business Internet Banking
500	SystemError	GENERAL_ERROR	System error

Transfers Error Codes

HTTP Status	Code	Title	Description
400	ValidationError	One or more validation errors occurred	Request body, query parameter or a specific field is provided incorrectly
400	DUPLICATED_SINGLE_TRANSFER_REQUEST	Duplicated Single Transfer Request	The same single transfer request has already been received / registered
400	VALIDATION_ERROR	Business validation message	Business validation failed
400	DomainError	Domain logic validation error	Business / domain validation failed
401	Unauthorized	Unauthorized access	Access token is not provided, is invalid or has expired
404	ObjectNotFound	Requested object was not found	The requested transfer, batch or request identifier could not be found
500	SystemError	An error occurred while processing your request	System error
500	ApplicationError	Application logic validation error	Application logic error

Examples

{
  "type": "/error-codes#ValidationError",
  "title": "INCORRECT_INPUT_DATA",
  "status": 400,
  "code": "ValidationError",
  "traceId": "00-e3ef7ef4921af4ba1ae82a47d858cb91-7c64ae632f372acf-01",
  "errors": {
    "PageSize": ["PageSize must be between 0 and 700."]
  }
}

{
  "type": "/error-codes#DUPLICATED_SINGLE_TRANSFER_REQUEST",
  "title": "Duplicated Single Transfer Request",
  "status": 400,
  "detail": "Duplicated Single Transfer Request",
  "code": "DUPLICATED_SINGLE_TRANSFER_REQUEST",
  "traceId": "00-b450c0c290093892957e751e5b4d54c9-dc7dd6bc42abfa20-01"
}

{
  "type": "/error-codes#Unauthorized",
  "title": "Unauthorized access",
  "code": "Unauthorized",
  "status": 401,
  "traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}