Upload

An Upload endpoint sends a file to Ocrolus for processing.

For requests to an Upload endpoint, expect:

📘

Request Method        : POST
Request Content-Type  : multipart/form-data

Response Content-Type : application/json

Example: Upload PDF to Book

📘

The formal specification of multipart/form-data request payloads can be found in RFC 7578.

For more information see the multipart/form-data Payloads Guide.

Size limits

In order to keep our product operating efficiently, we enforce a hard size limit of 200 MB or 3000 pages per Document. Uploaded files that exceed either of these limits will be discarded. If you need to upload such a file, consider one of the following solutions:

  • Compress your document. Ensure that embedded text data is preserved and that image data is legible.
  • If your file represents multiple documents, break each Document into its own file. For instance, you can submit each Schedule of a 1040 form separately.
  • Remove extra pages that don't contain relevant information, such as instructions for filling out forms.
  • If the document in question is a scanned image, submit a digital version with embedded text data if you have one.
  • Convert your document's scanned image data to grayscale or monochrome.

If your uploaded file exceeds the page limit, you will receive an error message that looks something like this:

{
  "status": 400,
  "code": 1512,
  "response": null,
  "message": "Document contains more than the maximum allowed pages. Please break the document up into multiple documents or contact support for assistance."
}

If your file exceeds the size limit, you will receive an HTTP 413 status code without a JSON body.

If you can't reduce the size of your file, contact customer support and we'll help resolve the issue.


See also