Technical Limitations

Technical limitations when integrating Mindee.

Overview

These limitations are designed to ensure the safety and stability of the Mindee API and platform.

Unless noted otherwise, any action that exceeds or does not comply with the limitations will be rejected with an error.

Accepted Files

PDF Files

All Portable Document Format (PDF) types can be processed, either single page or multiple pages.

Each PDF page can be a combination of text and image elements.

Image Files

Most common image types can be processed.

Specifically, we accept the following image types:

Type	Media Type	Extensions	Notes
	image/jpeg	jpeg, jpg
	image/png	png	non-animated only
WebP	image/webp	webp
	image/tiff	tiff, tif	single page or multiple pages
	image/heic	heic

URLs

When sending a file through an URL rather than binary data.

The source URL must adhere to the following rules:

• Secured using TLS (HTTPS).

• Publicly available using only the URL, no authentication headers.

• Authentication may be provided in the URL as query parameters: username+password or token. For example, Amazon S3 signed URLs will work.

• Contents must be a binary file (raw bytes, not base64-encoded).

• File contents cannot be encrypted, PDFs must not be password protected.

• The Mindee server will not follow redirections (HTTP 3xx).

File Limits

These limits apply to all files, regardless of source or type.

Limit type	Limit value
Max file size	100 MB
Maximum number of pages	200 pages

If you can have the file locally, there are workarounds available for these limits:

• Manipulate PDF Pages

• Compress Files

Requires using our Client Libraries / SDKs.

Rate Limits

If you have needs beyond these limits, get in touch with the sales team for a custom solution.

API Calls

For information about the pricing model of Mindee, please refer yourself to the pricing on the website.

Requests

Maximum request throughput	Limits
per hour	3000 requests
per minute	120 requests
per second	5 requests

General tip: You may space your API requests so that you don't go over the limit.

Data Schema

Number of Fields in the Data Schema

For your data schema, the recommended maximum number of properties is 25.

Beyond this limit, performance will be drastically reduced.

Names of Fields

The field name must only contain:

• lowercase Latin letters without accents (a-z)

• numbers (0-9)

• underscores (_)

Webhooks

Webhook URLs must adhere to the the following rules:

• Secured using TLS (HTTPS).

• Publicly available using only the URL, no authentication headers.

• Authentication may be provided in the URL as query parameters: username+password or token

• The Mindee server will not follow redirections (HTTP 3xx).

• The route should return OK (HTTP 2xx) when successful.