Build with Documiner

Quick Start

Get your first document extracted in under 5 minutes. You'll need an API token — request access if you don't have one yet.

1. Obtain an API token from us after signing up
2. Base64-encode your document file
3. Send a POST request to /api/parse-documents-sync with a JSON body containing FileName and Content
4. Parse the JSON array response — each element is a typed document object

curl -X POST https://documentminer.eu.jetveo.io/api/parse-documents-sync \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "FileName": "invoice.pdf",
    "Content": "'$(base64 -w0 invoice.pdf)'"
  }'

Authentication

All API requests must include a Bearer token in the Authorization header. Tokens are issued when you sign up for API access and can be scoped per integration.

Authorization: Bearer YOUR_API_TOKEN

POST/api/parse-documents-sync

Extracts structured data from a business document. Accepts a JSON body with the document file encoded as base64. Returns an array of typed document objects.

Request Body (application/json)

Other endpoints

Response Schema

A successful extraction returns HTTP 200 with a JSON array. Each element is a typed document object identified by a $type discriminator field. The structure of each object depends on the detected document type.

[
  {
    "$type": "Invoice",
    "InvoiceNumber": "2024-0042",
    "IssueDate": "2024-01-15",
    "DueDate": "2024-02-15",
    "Vendor": {
      "Name": "ACME s.r.o.",
      "RegistrationNumber": "12345678",
      "VatId": "CZ12345678",
      "Address": "Wenceslas Square 1, Prague"
    },
    "Buyer": {
      "Name": "Buyer Corp a.s.",
      "VatId": "CZ87654321"
    },
    "LineItems": [
      {
        "Description": "Software License Q1",
        "Quantity": 1,
        "UnitPrice": 45000,
        "VatRate": 21,
        "Total": 54450
      }
    ],
    "Totals": {
      "Subtotal": 45000,
      "Vat": 9450,
      "Total": 54450,
      "Currency": "CZK"
    }
  }
]

Document types

Code Examples

Complete, working examples for the most common integration languages. Replace YOUR_API_TOKEN with your actual token.

curl -X POST https://documentminer.eu.jetveo.io/api/parse-documents-sync \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "FileName": "invoice.pdf",
    "Content": "'$(base64 -w0 invoice.pdf)'"
  }'

Supported File Formats

ISDOC and ZUGFeRD are processed by dedicated native parsers, yielding 100% accuracy. All other formats use Documiner AI extraction.

Error Codes

Error responses include a JSON body with error, message, and request_id fields. Use request_id when contacting support.

Error response body

{
  "error": "unauthorized",
  "message": "API token is missing or invalid.",
  "request_id": "req_01HXZ3F8QK5Y2VWTN8B9GHJM4"
}

On-Premises Deployment

Documiner can be deployed inside your own infrastructure as a Docker container or a standalone binary. In both cases, you provide your own AI API key and data never leaves your environment. On-premises pricing is individual — contact us for details.

Docker

# Run with your AI API key
# (contact us for the Docker image)
docker run -d \
  -p 8080:8080 \
  -e AI_API_KEY=your_ai_key \
  -e API_SECRET=your_admin_secret \
  documiner:latest

# Extract a document
curl -X POST http://localhost:8080/api/parse-documents-sync \
  -H "Authorization: Bearer your_token" \
  -H "Content-Type: application/json" \
  -d '{"FileName":"invoice.pdf","Content":"<base64>"}'

Environment variables

OpenAPI Specification

The full API is described in an OpenAPI 3.1 specification. Import it into Postman, Insomnia, or any OpenAPI-compatible tool to explore and test the API interactively.

To view the spec interactively, paste the URL into editor.swagger.io.