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.

PDF files cannot be password-protected.

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

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 have access to the file locally, there are workarounds available for these limits:

• Manipulate PDF Pages

• Compress Files

Requires using our Client Libraries / SDKs.

URLs

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

All Accepted Files may be used, if they adhere to the File Limits.

In addition, 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).

Rate Limits

Calls to the Mindee API are limited to ensure the stability of the platform for all users.

These limits apply to an entire organization, meaning the combination of all models, origin IPs, and API keys.

The following limits are enforced:

Limit Type	Limit Value
Send for Processing	200 requests per minute
Polling	1200 requests per minute Normally, this is handled by the client library.

If rate limits are exceeded, the server will return a HTTP 429 error.

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

Data Schema

Number of Fields in the Data Schema

For your data schema, the recommended maximum number of fields 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.