Errors

Overview

Scan Documents API uses conventional HTTP response codes to indicate the success or failure of an API request. In general:

• Codes in the 2XX range indicate success.
• Codes in the 4XX range indicate problems with the request, like missing parameters.
• Codes in the 5XX range indicate problems with Scan Documents servers.

Errors messages conform to RFC 7807 and use a Content-Type of application/problem+json.

General Errors

This payload is for 4XX client errors, except validation errors, and 5XX errors.

Example

Here is an example of a 404 error response when a file is not found:

{
  "type": "https://scan-documents.com/docs/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "message": "File with id file_123 not found."
}

Validation Errors

This payload is for 4XX client errors that are caused by validation errors.

Example

Here is an example of a 422 error response when there is a validation error:

{
  "type": "https://scan-documents.com/docs/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "errors": {
      "input": ["input does not contains a valid input id."]
    }
}

Error Types Reference

For detailed information about each error type, including causes, solutions, and examples, visit the individual error pages:

Client Errors (4XX)

• 401 Unauthorized - Missing or invalid authentication credentials
• 404 Not Found - Requested resource does not exist
• 415 Unsupported File Type - File format not supported for the requested operation
• 422 Validation Error - Request parameters failed validation

Subscription & Access Errors

• 409 No Subscription - Active subscription required for this operation

Each error page provides detailed information about:

• When the error occurs
• Common causes
• How to fix the issue
• Code examples
• Best practices