Developers

API documentation.

Everything you need to call an OleeVision extractor from your own app. One endpoint in, clean JSON out.

Quickstart

Create an extractor in the app, copy its API key from the extractor page, then POST a document image to your endpoint.

1. Your endpoint

POST https://vision.oleon.io/api/v1/extract/YOUR_API_KEY

2. Send an image (multipart)

curl -X POST \
  "https://vision.oleon.io/api/v1/extract/YOUR_API_KEY" \
  -F "image=@document.jpg"

3. Or send an image URL (JSON)

curl -X POST \
  "https://vision.oleon.io/api/v1/extract/YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image_url": "https://example.com/doc.jpg" }'

Response

{
  "success": true,
  "data": {
    "invoice_no": "INV-2048",
    "date": "2026-06-14",
    "vendor": "Acme Supplies",
    "total": 1987.20
  }
}

Keep your key on the server. Call the API from your backend, never from browser code. If a key leaks, regenerate it instantly from the extractor page — the old one stops working right away.

Response codes

200

Success

Document processed, JSON returned in data.

401

Invalid key

The API key is wrong or missing.

403

Not approved / suspended

Extractor isn't approved yet, or the account is suspended.

429

Quota exceeded

You've hit your monthly read limit.

422

No text found

The document had no readable text.