NextOCR Bank Receipt API

1. What this API does

The bank receipt API accepts a receipt image and returns structured JSON fields such as:

• bank
• amount
• currency
• finished_at
• from_account
• paid_by
• receiver_bank_name
• reference
• trx, apv, hash when available

---

2. Endpoint

URL:

https://developer.nextocr.org/ocr_api_receipt

Method: POST

Content-Type: multipart/form-data

Authentication

Authentication requires a valid username and secret key. For security, do not share your real credentials publicly.

• Recommended: HTTP Headers
  X-Username: your_username
X-Secret-Key: your_secret_key
• Alternative: Query parameters
  ?username=your_username&key=your_secret_key
• Alternative: Form fields
  username=your_username
key=your_secret_key

---

3. cURL Example

Example request:

curl -X POST \
  -H "X-Username: your_username" \
  -H "X-Secret-Key: your_secret_key" \
  -F "file=@001.jpg" \
  "https://developer.nextocr.org/ocr_api_receipt"

Example JSON response:

{
  "bank": "AC",
  "fields": {
    "amount": "2.75",
    "apv": null,
    "bank_method": null,
    "currency": "USD",
    "finished_at": "2026-01-11 09:18AM",
    "from_account": "093 XXX XXX",
    "hash": null,
    "paid_by": "PRIVATE USER",
    "receiver_bank_name": "PRIVATE RECEIVER",
    "reference": "60111178073",
    "trx": null,
    "trx_date": "2026-01-11 09:18AM"
  },
  "msg": "OCR text extracted successfully. Raw receipt text hidden in public documentation for privacy.",
  "status": true
}

---

4. Response format

The API returns a JSON object with:

• status: whether the request succeeded
• bank: predicted bank name
• fields: parsed structured receipt fields
• msg: OCR text or processing message

Some fields may be null if they are not available in the uploaded receipt.

---

5. Try it in your browser

Username

Secret Key

Select bank receipt image

Convert Receipt to JSON

---

6. Common use cases

• Receipt image to JSON
• Payment verification
• Bank transfer confirmation parsing
• ERP and accounting automation
• Internal reconciliation pipeline
• Fintech backend integration

---

7. Notes

• Supported output depends on the receipt quality and bank layout.
• Different banks may expose different fields.
• For production usage, keep credentials on the server side whenever possible.
• Do not publish raw receipt images or raw OCR text containing customer information.