API documentation
Authenticate every OCR request with a Bearer API key from your mvslip dashboard.
Endpoint
POST https://mvslip.com/api/v1/ocr
Request
- Header:
Authorization: Bearer <api_key> - Optional header:
Idempotency-Key - Multipart field:
image(JPEG, PNG, or WebP)
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
- 401 invalid key
- 402 credit limit reached
- 413 / 415 invalid or oversized image
- 429 rate limited