Complete list of API error codes for exception handling

OCR.space Free OCR API
1

Hi team,

I’m implementing comprehensive error handling for API integration and need a complete reference of all possible error codes and their meanings.

Currently, I’m encountering errors like:

  • E208: Some internal processing error occurred. Please give us some time, we are looking into this!

  • E101: Timed out waiting for results

However, I haven’t been able to find documentation covering all possible error codes. The official API documentation doesn’t include a comprehensive error code reference, and searching through the forum hasn’t yielded a complete list either.

Questions:

  1. Is there a complete list of all API error codes (E101, E208, etc.) with descriptions?

  2. What’s the recommended approach for handling each error type (retry logic, backoff strategies, etc.)?

  3. Are these error codes stable, or should I expect them to change?

Having this reference would help me implement proper exception handling and provide better user experience and fallback logic when issues occur.

Thanks in advance for any guidance!

2

Thanks for this feedback. We will expand our API documentation accordingly.

  1. Is there a complete list of all API error codes (E101, E208, etc.) with descriptions?

Not yet, but we plan to provide it soon.

  1. What’s the recommended approach for handling each error type (retry logic, backoff strategies, etc.)?

It depends on the error code.

  • For E101 (timeout) → Please retry.
  • E208 we recommend to retry on another endpoint, to rule out endpoint specific issues. However, E208 could also indicate a problem with the image/PDF that you are sending. If the issue persists for a certain document, please contact tech support.
  1. Are these error codes stable, or should I expect them to change?

They are stable!