Online Banking API: Error Handling

Handling API Errors

The Online Banking API returns a JSON object in the body of the response any time an error occurs. There will also be an appropriate HTTP Error code per REST standards.

The rest of this page provides a reference of errors, with some guidance on how to handle them in your app.

JSON Error format


{
  "ErrorCode": "000000",
  "DisplayMessage": "Text that the member might see",
  "TechnicalMessage": "Text that will be helpful for troubleshooting",
  "Timestamp": "Long DateTime"
}
Parameter Description
DisplayMessage This text should be displayed to the member when an error occurs
TechnicalMessage This message is for the developer and CU*Answers staff. This is a deeper piece of information that can help in troubleshooting problems.
Timestamp A long date and time stamp, in the following format: “MM/dd/yyyy HH:mm:ss AM/PM”

Common Error Codes

Below are error codes common to all API calls. Each API also contains errors specific to that endpoint, so make sure you look in the specfications of the endpoint you are calling for more information.

Code HTTP Code Description
NF12345704 500 Application keys not found. Contact CU*Answers.
NA12345746 500 Online banking is not active for this Credit Union.
9999999999 500 Requested data not found.
8888888888 403 Requested data not found.
API2000 403 Forbidden: You are not authorized to use this resource.
API2010 403 Forbidden: You are not authorized to use this resource.
API2011 403 Forbidden: You are not authorized to use this resource. Whitelist Issue.
API2012 403 Forbidden: You are not authorized to use this resource.
API2013 403 Forbidden: You are not authorized to use the Accounts API.
API2014 403 Forbidden: You are not authorized to use the Members API.
API2015 403 Forbidden: You are not authorized to use the CreditUnions API.
API2016 403 Forbidden: You are not authorized to use the Transfers API.
API4000 403 Forbidden: You are not authorized to use this resource.
HTTP404 404 The location requested could not be found.
HTTP415 400 The media type requested is not supported. Please use application/json.
OB110 400 The AppKey is missing.
OB111 400 The session token is missing.
OB112 400 The user token is missing.
OB113 403 The id is missing.
OB201 403 The AppKey provided could not be verified.
OB202 403 The AppKey provided could not be verified against the credit union id.
OB203 403 Mismatch between AppKey and credit union id.
OB204 400 Credit union id could not be found. Please validate HttpHeader parameters are valid.
OB310 403 Data received is incomplete. Please validate the data being sent in and try again.
OB500 503 Online access is currently disabled, please try again later or contact the Credit Union for assistance.
OB503 500 [This message changes based on CU Configuration for maintenance]
OB510 500 Data could not be retrieved for this request, please try again or contact the Credit Union for assistance.
OB511 500 Data could not be retrieved for this request, please try again.
NO12345690 500 There was a problem processing your request. Please try again or contact CU*Answers.
NF12345703 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345678 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345732 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345679 500 There was a problem processing your request. Please try again or contact CU*Answers.
NF12345727 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345699 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345708 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345707 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345725 500 There was a problem processing your request. Please try again or contact CU*Answers.
NO12345726 500 There was a problem processing your request. Please try again or contact CU*Answers.
BT12345681 500 There was a problem processing your request. Please try again or contact CU*Answers.
BT12345682 500 There was a problem processing your request. Please try again or contact CU*Answers.
SC12345684 500 There was a problem processing your request. Please try again or contact CU*Answers.
SC12345683 500 There was a problem processing your request. Please try again or contact CU*Answers.
SC12345692 500 There was a problem processing your request. Please try again or contact CU*Answers.
SC12345693 500 There was a problem processing your request. Please try again or contact CU*Answers.
SC12345698 500 There was a problem processing your request. Please try again or contact CU*Answers.
SC12345735 500 There was a problem processing your request. Please try again or contact CU*Answers.
NF12345703 500 There was a problem processing your request. Please try again or contact CU*Answers.