ZUzuva
OCR

Get OCR requests

Changed on

Retrieves the status of one or more OCR status requests. Each request ID should be provided as a query parameter, e.g. /ocrs?request_id=abcde&request_id=fghijk

If any or all request IDs are invalid or not found, the overall response will be 200 Success, and the response body will contain the individual error messages for each request ID.

A maximum of 1000 request IDs can be included in a single query.

get/ocrs

Request

Query parameters

request_idstring[] required

OCR request IDs

Response

The status of multiple OCR requests

errorsobject required
num_errorsinteger required
num_foundinteger required
statusesobject required

Example response

{
  "errors": {
    "cc1oi51qqhquidfjhiu0": {
      "error": {
        "code": "request_not_found",
        "message": "The specified request ID cannot be found"
      }
    }
  },
  "num_errors": 1,
  "num_found": 1,
  "statuses": {
    "cc1oi51qqhquidfjmiu0": {
      "file_id": "c5e407f1qk1er7odm6tg",
      "status": "complete",
      "request_id": "c5e463f1qk154j5e3sjg"
    }
  }
}

Changes

  • 51f2a4c5de2eRevision changes
    • info

      for the query request parameter request_id, the type was generalized from string to array

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 7cace20deba7Revision changes
    • info

      endpoint added