All successfully processed API requests return a JSON response with a status of 200 and a message of OK.
{
"status": 200,
"message": "OK",
"response": "..."
}
If processing a request generates an application error, the JSON response reports the errors as follows:
- The
statusattribute will have a value other than200. - The
messageattribute will contain a descriptive explanation of the error. - The
codeattribute will identify the category of error.
{
"status": 400,
"message": "Authentication failed",
"code": 1200,
"response": null
}
Ocrolus API error codes
| Status | Code | Reason |
|---|---|---|
| 400 | 1002 | Could not decode JSON string |
| 400 | 1003 | Request validation failure; check parameter values and types. |
| 400 | 1005 | Request verification rate limit exceeded |
| 400 | 1100 | The request could not be processed |
| 400 | 1101 | The requested endpoint does not exist |
| 400 | 1103 | Required parameter not found |
| 400 | 1104 | The parameter value is not a valid file |
| 400 | 1109 | The file is not a valid PDF |
| 400 | 1200 | Authentication failed |
| 400 | 1204 | Invalid API key credentials |
| 400 | 1306 | Email and/or password not found |
| 400 | 1307 | Account is not active |
| 400 | 1308 | Account is not verified |
| 400 | 1313 | Account info not found |
| 400 | 1316 | Account does not have required manager permissions |
| 400 | 1317 | Account is not a member of the organization |
| 400 | 1323 | Your organization has been deleted |
| 400 | 1398 | Organization not found |
| 400 | 1399 | Account not found |
| 400 | 1401 | Book not found |
| 400 | 1402 | Book already exists |
| 400 | 1404 | Book containing documents pending verification |
| 400 | 1500 | A DocumentError occurred |
| 400 | 1501 | Document not found |
| 400 | 1502 | Document exists |
| 400 | 1504 | PageDoc not found |
| 400 | 1508 | Page index out of range |
| 400 | 1511 | Mixed document is pending classification. |
| 400 | 1512 | Document contains more than the maximum allowed pages. See here for more information. |
| 400 | 1513 | An error occured while processing instant ML document. |
| 400 | 1601 | Transaction not found |
| 400 | 1609 | Transaction is already marked as a transfer |
| 400 | 1702 | Bank account was not found |
| 400 | 2100 | Invalid permission |
| 400 | 2101 | No permission to access this endpoint |
| 400 | 2102 | No permission to access this book |
| 400 | 2103 | Account permission error |
| 400 | 2104 | No permission to access this doc |
| 400 | 2105 | No permission to access this page |
| 400 | 2106 | No permission to access this txn |
| 400 | 2107 | No permission to access this form |
| 400 | 2108 | No permission to access this uploaded image group |
| 400 | 2109 | No permission to access this bank account |
| 400 | 2110 | No permission to upload any document |
| 400 | 2111 | No permission to create new books |
| 400 | 2300 | Database error |
| 400 | 2401 | Error fetching final result from paystub service |
| 400 | 2500 | Error from mortgage service |
| 400 | 5001 | Filter exists |
| 400 | 5002 | Filter not found |
| 400 | 6001 | Form type not found |
| 400 | 7001 | Tag not found |
| 400 | 7002 | Image group not found |
| 400 | 7003 | No form config found |
| 400 | 7004 | Page index missing from uploaded images in the image bucket |
| 400 | 8001 | This endpoint only accepts 1 file uploaded each time |
| 400 | 8002 | This book has reached the maximum allowable uploads. |
| 400 | 9001 | The analytics generation exceeded the maximum execution time. Please try again later or contact [email protected]. |
| 400 | 9002 | Analytics is not supported for this type of case |
| 400 | 9003 | Analytics (JSON) can only process analytics for bank statements |
| 400 | 9101 | This organization does not have the permission required to retrieve the SentiLink score. Please contact support for more information. |
| 400 | 9102 | SentiLink score could not be retrieved due to an invalid field. Please contact support for further assistance |
| 400 | 9103 | SentiLink score could not be retrieved due to a missing field. Please contact support for further assistance |
| 400 | 9104 | SentiLink is not reachable. Please try again later |
| 404 | 9006 | No transactions found in the book |
| 422 | 1100 | Book transaction limit exceeded |
| 425 | 9004 | Analytics are still being processed, please check back momentarily |