API Errors

API Troubleshooting

Unfortunately, API requests sometimes don’t go as planned.

As you build your API client, we recommend that you include some logic if you receive an error with status 500 (see table below). If you receive an error with status 500, then the API client should retry the request after 1 minute. If it fails again for some reason, then retry the request after 3 minutes. If this attempt also fails, then stop and try during the next business day. At this point, you can store this request information somewhere and mark it as “try again tomorrow.”

API Request Error Codes

We have incorporated detailed and comprehensive error messages to make sure that you are well informed and able to complete your request. Find all of our error codes and associated error messages below:

Error Code  
400 Bad request message
401 Unauthorized: Incorrect username or password / Token is invalid or expired
422 Validation error message
500 Internal system error. Please contact the administrator.