Manual Integration

Manual integration - reference only.

We do not recommend manually integrating, and cannot guarantee full support in this case.

Recommended integrations:

• Client Libraries / SDKs

• No-Code Integrations

Also take a look at the Integration Overview if you are setting up your integration for the first time.

If you would like to download the OpenAPI specification directly, it is available here: https://api-v2.mindee.net/openapi.json

Send a file for an extraction product inference.

post

Send a file to the asynchronous processing queue for an extraction inference.

Results can be retrieved in two ways:

• Loop on the polling_url endpoint in the response until the status is Processed or Failed (polling).

• Use a webhook to be notified when the inference is finished. Webhooks can be configured on the platform on a per-model basis.

Inferences taking longer than 590 seconds will time out.

Authorizations

APIKeyHeader

AuthorizationstringRequired

Body

multipart/form-data

Form to enqueue an inference for extraction models.

model_idstring · uuid4Required

Model ID to use for the inference.

fileany ofOptional

Upload a file as bytes. Required if url is not provided.

string · binaryOptional

or

nullOptional

urlany ofOptional

Download the file from a URL, must be secure (HTTPS) and publicly available. Required if file is not provided.

string · uri · min: 1 · max: 2048Optional

or

nullOptional

file_base64any ofOptional

Upload a file as a base 64 string. Used as an alternative to file. Not recommended, for specific use only.

Example: Base64String==

string · min: 15Optional

or

nullOptional

webhook_idsstring · uuid4[]Optional

Webhook IDs to call after all processing is finished. If empty, no webhooks will be used.

aliasany ofOptional

Use an alias to link the file to your own DB. If empty, no alias will be used.

Example: my_file_alias

stringOptional

or

nullOptional

raw_textany ofOptional

Extract the entire text from the document as strings, and fill the raw_text attribute.

booleanOptional

or

nullOptional

polygonany ofOptional

Calculate bounding box polygons for values, and fill the locations attribute of fields

booleanOptional

or

nullOptional

confidenceany ofOptional

Calculate confidence scores for values, and fill the confidence attribute of fields. Useful for automation.

booleanOptional

or

nullOptional

ragany ofOptional

Use Retrieval-Augmented Generation during inference.

booleanOptional

or

nullOptional

text_contextany ofOptional

Pass additional context for use by the model, for this inference.

Example: This document is a receipt from a grocery store.

stringOptional

or

nullOptional

data_schemaany ofOptional

Dynamically change the data schema of the model, for this inference.

stringOptional

or

nullOptional

Responses

202

Successful Response

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

post

/v2/products/extraction/enqueue

HTTPcURLJavaScriptPython

POST /v2/products/extraction/enqueue HTTP/1.1
Host: api-v2.mindee.net
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 288

{
  "model_id": "text",
  "file": "binary",
  "url": "https://example.com",
  "file_base64": "Base64String==",
  "webhook_ids": [
    "text"
  ],
  "alias": "my_file_alias",
  "raw_text": true,
  "polygon": true,
  "confidence": true,
  "rag": true,
  "text_context": "This document is a receipt from a grocery store.",
  "data_schema": "text"
}

{
  "job": {
    "id": "text",
    "model_id": "text",
    "filename": "file.jpg",
    "alias": "text",
    "created_at": "2026-02-23T18:05:11.293Z",
    "status": "Processing",
    "polling_url": "https://example.com",
    "result_url": "https://example.com",
    "webhooks": [
      {
        "id": "text",
        "created_at": "2026-02-23T18:05:11.293Z",
        "status": "Processing",
        "error": {
          "status": 422,
          "detail": "One or more fields failed validation.",
          "title": "Invalid fields in form",
          "code": "422-001",
          "errors": [
            {
              "pointer": "#/model_id",
              "detail": "'model_id' must be a valid UUID format"
            }
          ]
        },
        "attempts_count": 0
      }
    ],
    "error": {
      "status": 422,
      "detail": "One or more fields failed validation.",
      "title": "Invalid fields in form",
      "code": "422-001",
      "errors": [
        {
          "pointer": "#/model_id",
          "detail": "'model_id' must be a valid UUID format"
        }
      ]
    }
  }
}

Here is a working example of the built-in test client:

Extraction Processed

When an extraction inference is processed, this payload is sent to the specified webhooks.

Webhooks are specified in the webhooks_ids parameter when enqueuing an extraction inference.

Payload

application/json

Response for an extraction inference.

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

Payload

{
  "inference": {
    "id": "text",
    "job": {
      "id": "text"
    },
    "model": {
      "id": "text"
    },
    "file": {
      "name": "text",
      "alias": "text",
      "page_count": 1,
      "mime_type": "text"
    },
    "result": {
      "fields": {
        "ANY_ADDITIONAL_PROPERTY": {
          "locations": [
            {
              "polygon": [
                []
              ],
              "page": 1
            }
          ],
          "confidence": "Certain",
          "value": true
        }
      },
      "raw_text": {
        "pages": [
          {
            "content": "text"
          }
        ]
      },
      "rag": {
        "retrieved_document_id": "text"
      }
    },
    "active_options": {
      "raw_text": true,
      "polygon": true,
      "confidence": true,
      "rag": true,
      "multipage_context": true,
      "text_context": true,
      "data_schema": {
        "replace": true
      }
    }
  }
}

Get the status of a file's processing.

get

Get the status of an inference that was previously enqueued.

If you are using webhooks there is no need to call this route.

When the job status is Processing or Failed the return code will be HTTP 200.

When the job status is Processed the return code will be HTTP 302.

The processing result can then be retrieved in two ways:

• Recommended: Using a GET on the URL specified in the result_url field of the response

• Allowing your client to redirect on the Location header of the response

Note: set the redirect parameter to false to disable the redirection behavior, and always return HTTP 200.

Authorizations

APIKeyHeader

AuthorizationstringRequired

Path parameters

job_idstring · uuid4Required

UUID of the job to retrieve

Query parameters

redirectbooleanOptional

Automatically redirect to the result URL

Default: true

Responses

200

Successful Response

application/json

Response for a Job.

302

Found

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

get

/v2/jobs/{job_id}

HTTPcURLJavaScriptPython

GET /v2/jobs/{job_id} HTTP/1.1
Host: api-v2.mindee.net
Authorization: YOUR_API_KEY
Accept: */*

{
  "job": {
    "id": "text",
    "model_id": "text",
    "filename": "file.jpg",
    "alias": "text",
    "created_at": "2026-02-23T18:05:11.293Z",
    "status": "Processing",
    "polling_url": "https://example.com",
    "result_url": "https://example.com",
    "webhooks": [
      {
        "id": "text",
        "created_at": "2026-02-23T18:05:11.293Z",
        "status": "Processing",
        "error": {
          "status": 422,
          "detail": "One or more fields failed validation.",
          "title": "Invalid fields in form",
          "code": "422-001",
          "errors": [
            {
              "pointer": "#/model_id",
              "detail": "'model_id' must be a valid UUID format"
            }
          ]
        },
        "attempts_count": 0
      }
    ],
    "error": {
      "status": 422,
      "detail": "One or more fields failed validation.",
      "title": "Invalid fields in form",
      "code": "422-001",
      "errors": [
        {
          "pointer": "#/model_id",
          "detail": "'model_id' must be a valid UUID format"
        }
      ]
    }
  }
}

Get the result of a completed extraction product inference.

get

Get the result of an extraction inference that was previously enqueued.

The inference will only be available after it has finished processing.

If you are using webhooks there is no need to call this route. However, the JSON payload described here is what will be sent to each specified webhook's URL.

If you activated the "Delete extracted data when fetched" option for the model, the inference will be deleted after this route completes. Any further requests to the same inference ID will return a 404.

Authorizations

APIKeyHeader

AuthorizationstringRequired

Path parameters

inference_idstring · uuid4Required

UUID of the inference to retrieve

Responses

200

Successful Response

application/json

Response for an extraction inference.

404

Not Found

application/json

422

Unprocessable Content

application/json

get

/v2/products/extraction/results/{inference_id}

HTTPcURLJavaScriptPython

GET /v2/products/extraction/results/{inference_id} HTTP/1.1
Host: api-v2.mindee.net
Authorization: YOUR_API_KEY
Accept: */*

{
  "inference": {
    "id": "text",
    "job": {
      "id": "text"
    },
    "model": {
      "id": "text"
    },
    "file": {
      "name": "text",
      "alias": "text",
      "page_count": 1,
      "mime_type": "text"
    },
    "result": {
      "fields": {
        "ANY_ADDITIONAL_PROPERTY": {
          "locations": [
            {
              "polygon": [
                []
              ],
              "page": 1
            }
          ],
          "confidence": "Certain",
          "value": true
        }
      },
      "raw_text": {
        "pages": [
          {
            "content": "text"
          }
        ]
      },
      "rag": {
        "retrieved_document_id": "text"
      }
    },
    "active_options": {
      "raw_text": true,
      "polygon": true,
      "confidence": true,
      "rag": true,
      "multipage_context": true,
      "text_context": true,
      "data_schema": {
        "replace": true
      }
    }
  }
}