ReceViz documentation

What it does

• Reads the fields you define. Start from a receipt or invoice template, or write your own document type: the fields, the labels they are printed under, the checks they must pass.
• Shows its evidence. Values come with the printed text, the page and the box they were read from, a confidence, and the checks that backed them.
• Checks before it trusts. Patterns, ranges, dates and the document's own sums run on every standard request; an optional second reader re-reads only the uncertain fields, and must point at the printed lines for anything it says.
• Says when a person should look. review.required and its reasons tell your code which results to accept and which to show someone.

Quick start

1. Request access for your organization, then open the console.
2. Create an application in the development environment, add a document type from the Payment Terminal Receipt template and publish it, and create a secret key. Keep the key on your server as RECEVIZ_SECRET_KEY.
3. Send a photo of a receipt:

RECEVIZ_API="https://accounthouse-backend-793493499887.me-central1.run.app/api/receviz/v1"

curl "$RECEVIZ_API/extractions" \
  -H "Authorization: Bearer $RECEVIZ_SECRET_KEY" \
  -F "file=@receipt.jpg" \
  -F "document_type=payment_receipt" \
  -F "mode=standard"

4. Read the answer. data is what you store; fields is the evidence for each value; review.required says whether a person should check it.

{
  "id": "rv_req_8fK2aQ0zT3mN1pL5vB7xY9",
  "object": "extraction",
  "status": "succeeded",
  "document_type": "payment_receipt",
  "schema_version": 1,
  "mode": "standard",
  "data": {
    "amount": 150,
    "currency": "AED",
    "transaction_date": "2026-09-26",
    "transaction_time": "14:05",
    "receipt_number": "000102",
    "rrn": "626914123456",
    "auth_code": "A1B2C3",
    "terminal_id": "12345678",
    "payment_method": "card",
    "card_scheme": "visa",
    "card_last_four": "4242",
    "approved": true,
    "merchant": "BLUE DHOW CAFE",
    "merchant_address": "DUBAI MARINA WALK"
  },
  "fields": {
    "amount": {
      "value": 150,
      "type": "currency",
      "status": "ok",
      "confidence": 0.906,
      "verified": false,
      "checks": [],
      "source": "rules",
      "page": 1,
      "bounding_box": {
        "x": 0.77,
        "y": 0.7136,
        "width": 0.18,
        "height": 0.05
      },
      "raw_text": "AED 150.00"
    }
  },
  "review": {
    "required": false,
    "reasons": []
  }
}

The full quick start explains each step, and client tokens let a web page or an app send documents without holding your key.

Guides