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. |