API documentation

Authenticate every OCR request with a Bearer API key from your mvslip dashboard.

Endpoint

POST https://mvslip.com/api/v1/ocr

Request

Examples

Send a receipt image as multipart form data. Replace YOUR_API_KEY with a key from your dashboard.

curl -X POST "https://mvslip.com/api/v1/ocr" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: receipt-001" \
  -F "image=@slip.jpg"

Success response

{
  "success": true,
  "reference_found": true,
  "transaction_successful": true,
  "bank_name": "Maldives Islamic Bank",
  "reference": "900000001",
  "date": "30/07/2026",
  "date_raw": "30/07/2026",
  "days_ago": 0,
  "amount": 125.5,
  "amount_raw": "125.50",
  "currency": "MVR",
  "sender_name": "Demo Sender",
  "sender_account": null,
  "recipient_name": "Sample Shop",
  "recipient_account": "7730000000002",
  "full_text": "..."
}

Errors