Monite OCR

Maximize the potential of the Monite OCR engine.

Overview

Monite’s OCR provides a flexible, standalone endpoint for extracting text data from documents across multiple formats, including PDF, JPG, and PNG. The Monite OCR returns a structured JSON response with all detected text data for contextual analysis, enabling use cases such as receipt parsing, contract analysis, or custom form data extraction. The response retains the extracted content without post-processing, allowing you to integrate and manipulate the data according to your specific requirements.

This OCR endpoint is a generic one and is not meant to replace the existing OCR for Accounts Payable (AP).

Considerations and limitations

  • The OCR process is asynchronous and the processing time may vary according to the document size.
  • The maximum image file size is 10 MB.
  • Multipage PDF files can have up to 10 pages.

Covered languages

Here is the list of languages that Monite OCR supports:

  • Afrikaans
  • Arabic
  • Armenian
  • Bulgarian
  • Catalan
  • Chinese
  • Croatian
  • Czech
  • Danish
  • Dutch
  • English
  • Estonian
  • Finnish
  • French
  • German
  • Greek
  • Hungarian
  • Icelandic
  • Indonesian
  • Italian
  • Japanese
  • Korean
  • Lao
  • Latvian
  • Lithuanian
  • Malay
  • Norwegian
  • Polish
  • Portuguese
  • Romanian
  • Russian
  • Serbian
  • Slovak
  • Slovenian
  • Spanish
  • Swedish
  • Turkish
  • Ukrainian
  • Vietnamese

Create an OCR task

There are two ways you can send a document for OCR recognition:

The OCR scanning might take up to 10-15 seconds, so it is recommended to poll the document every 5 seconds. In the meantime, the document’s status field is set as processing and the recognized_data field is not populated yet.

The webhook ocr_task.finished is triggered once the OCR has finished processing the file and storing the extracted data.

Process file via URL

To process a file, thus creating an OCR task, call POST /ocr_tasks. The query parameter document_type is mandatory and its possible values are invoice, credit_note, and receipt:

1curl -X POST 'https://api.sandbox.monite.com/v1/ocr_tasks' \
2  -H 'accept: application/json' \
3  -H 'x-monite-version: 2024-01-31' \
4  -H 'x-monite-entity-id: aad60980-e2d0-436d-aa68-b9463f39870c' \
5  -H 'Content-Type: application/json' \
6  -d '{
7        "document_type": "invoice",
8        "file_url": "https://www.file.com/invoice.pdf"
9  }'

The 202 Accepted response contains the information found in the file:

1{
2  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3  "created_at": "2025-02-11T14:18:01.013Z",
4  "updated_at": "2025-02-11T14:18:01.013Z",
5  "status": "success",
6  "document_type": "invoice",
7  "recognized_data": {
8    "type": "invoice",
9    "currency": "EUR",
10    "due_date": "2025-02-25",
11    "issue_date": "2025-02-11",
12    "document_number": "DE2287",
13    "sender": {
14      "vat_number": "DE123456789",
15      "tax_number": "123/456/78901",
16      "email": "billing@acme-corp.com",
17      "name": "Acme Corporation",
18      "address": {
19        "street_and_number": "123 Business Road",
20        "city": "Berlin",
21        "postal_code": "10115",
22        "country": "DE",
23        "state": "Berlin"
24      },
25      "bank_account": {
26        "bank_account_number": "1234567890",
27        "iban": "DE89370400440532013000",
28        "swift_bic": "COBADEFFXXX"
29      }
30    },
31    "recipient": {
32      "vat_number": "FR987654321",
33      "tax_number": "FR12345678901",
34      "email": "finance@xyz-enterprise.fr",
35      "name": "XYZ Enterprise",
36      "address": {
37        "street_and_number": "456 Market Street",
38        "city": "Paris",
39        "postal_code": "75001",
40        "country": "FR",
41        "state": "Île-de-France"
42      },
43      "bank_account": {
44        "bank_account_number": "0987654321",
45        "iban": "FR7630006000011234567890189",
46        "swift_bic": "BNPAFRPPXXX"
47      }
48    },
49    "subtotal": 2000.00,
50    "total_amount": 2380.00,
51    "tax_amount": 380.00,
52    "tax_rate": 19.00,
53    "amount_paid": 0.00,
54    "payment_terms": "Payment due within 14 days",
55    "line_items": [
56      {
57        "line_reference": "ITEM001",
58        "name": "Consulting Services",
59        "description": "IT consulting services for January 2025",
60        "quantity": 10,
61        "unit_price": 200.00,
62        "unit": "hour",
63        "subtotal": 2000.00,
64        "tax_rate": 19.00,
65        "tax_amount": 380.00,
66        "total_amount": 2380.00
67      }
68    ]
69  }
70}

Upload from file

You can upload files in the PDF, PNG, or JPG format by calling POST /ocr_tasks/upload_from_file. The query parameter document_type is mandatory and its possible values are invoice, credit_note, and receipt:

1curl -X POST 'https://api.sandbox.monite.com/v1/ocr_tasks/upload_from_file?document_type=invoice' \
2  -H 'accept: application/json' \
3  -H 'x-monite-version: 2024-01-31' \
4  -H 'x-monite-entity-id: 3b28a315-1e10-46bf-8d83-37f64147ae9f' \
5  -H 'Content-Type: multipart/form-data' \
6  -F 'file=@Invoice-01-25.pdf;type=application/pdf'

The sucessful 202 Accepted response contains the id and other parameters of the file:

1{
2  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3  "created_at": "2025-02-11T14:18:01.013Z",
4  "updated_at": "2025-02-11T14:18:01.013Z",
5  "status": "success",
6  "document_type": "invoice",
7  "recognized_data": {
8    "type": "invoice",
9    "currency": "EUR",
10    "due_date": "2025-02-25",
11    "issue_date": "2025-02-11",
12    "document_number": "DE2287",
13    "sender": {
14      "vat_number": "DE123456789",
15      "tax_number": "123/456/78901",
16      "email": "billing@acme-corp.com",
17      "name": "Acme Corporation",
18      "address": {
19        "street_and_number": "123 Business Road",
20        "city": "Berlin",
21        "postal_code": "10115",
22        "country": "DE",
23        "state": "Berlin"
24      },
25      "bank_account": {
26        "bank_account_number": "1234567890",
27        "iban": "DE89370400440532013000",
28        "swift_bic": "COBADEFFXXX"
29      }
30    },
31    "recipient": {
32      "vat_number": "FR987654321",
33      "tax_number": "FR12345678901",
34      "email": "finance@xyz-enterprise.fr",
35      "name": "XYZ Enterprise",
36      "address": {
37        "street_and_number": "456 Market Street",
38        "city": "Paris",
39        "postal_code": "75001",
40        "country": "FR",
41        "state": "Île-de-France"
42      },
43      "bank_account": {
44        "bank_account_number": "0987654321",
45        "iban": "FR7630006000011234567890189",
46        "swift_bic": "BNPAFRPPXXX"
47      }
48    },
49    "subtotal": 2000.00,
50    "total_amount": 2380.00,
51    "tax_amount": 380.00,
52    "tax_rate": 19.00,
53    "amount_paid": 0.00,
54    "payment_terms": "Payment due within 14 days",
55    "line_items": [
56      {
57        "line_reference": "ITEM001",
58        "name": "Consulting Services",
59        "description": "IT consulting services for January 2025",
60        "quantity": 10,
61        "unit_price": 200.00,
62        "unit": "hour",
63        "subtotal": 2000.00,
64        "tax_rate": 19.00,
65        "tax_amount": 380.00,
66        "total_amount": 2380.00
67      }
68    ]
69  }
70}

List all OCR tasks

To obtain a list of all OCR tasks, call GET /ocr_tasks.

Retrieve a specific OCR task

To obtain information about a specific OCR task, call GET /ocr_tasks/{task_id}.