> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mindee

> Extract structured data from invoices, receipts, and other financial documents with Mindee's OCR API

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `MINDEE_API_KEY` is sent as the `Token` prefixed `Authorization` header.
* **Docs**: [https://docs.mindee.com/integrations/api-keys](https://docs.mindee.com/integrations/api-keys)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable         | Required | Description                                                                                                                            |
| ---------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `MINDEE_API_KEY` | Yes      | Mindee API key from the Mindee platform (sent as 'Authorization: Token \<key>') [Docs](https://docs.mindee.com/integrations/api-keys). |

## Setup

1. **Create a free Mindee account**: Sign up at [https://platform.mindee.com](https://platform.mindee.com) - no payment details required. The free plan includes a monthly page allowance, so you can start parsing documents immediately.
2. **Get your API key**: A development API key is generated for you as soon as your account exists. Find it in the Mindee platform under API Keys, and store it as MINDEE\_API\_KEY. It is sent on every request as 'Authorization: Token \<key>'.
3. **Test with a sample document**: Run the Parse Invoice tool with a publicly accessible URL of a sample invoice PDF, or the file's base64-encoded contents, and check that structured fields come back.

* The 'document' field accepts either a base64-encoded file or a publicly accessible HTTPS URL; URL inputs must be reachable without authentication
* These tools call Mindee's V1 product APIs (api.mindee.net): Invoice v4, Receipt v5, and Financial Document v1; Mindee's newer model-based V2 platform (api-v2.mindee.net) uses per-account model IDs and is not covered here
* Each predict call consumes pages from your plan's quota (multi-page PDFs consume one page per parsed page)

Provider API reference: [https://docs.mindee.com](https://docs.mindee.com)

## Tools

| Tool                     | Access | Description                                                                                                                                                                                                                                             |
| ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Parse Invoice            | Write  | Extract structured fields (supplier, customer, line items, totals, taxes, dates, payment details) from an invoice PDF or image using the Invoice OCR model. Consumes a page of your Mindee quota per call.                                              |
| Parse Receipt            | Write  | Extract structured fields (merchant, date, time, category, line items, taxes, total amounts, tip) from an expense receipt photo or PDF using the Receipt OCR model. Consumes a page of your Mindee quota per call.                                      |
| Parse Financial Document | Write  | Parse a document that may be either an invoice or a receipt: the Financial Document model classifies it and returns the union of invoice and receipt fields. Use this when the document type is unknown. Consumes a page of your Mindee quota per call. |

## Example prompts

* Parse this invoice with Mindee and summarize the supplier, invoice number, due date, line items, and total amount.
* Parse this receipt with Mindee and give me the merchant, date, category, and total so I can log the expense.