VUZDevelopers

Process receipt/invoice with OCR and AI

POST
/expense-management/ocr/process
  Processes documents with advanced OCR capabilities including:  - Hebrew and English text recognition  - AI-powered field extraction (GPT-4 Vision)  - Visual annotations with bounding boxes  - Israeli VAT validation (18%)  - Automatic field suggestions and validation

Authorization

X-Api-Key<token>

Business API key, e.g. vuz_ab12cdef... Created via Settings → Integrations → API Keys. Unlike partner keys, a public API key's STRING does not encode its environment — isolation instead comes from a completely separate sandbox database: a key minted on the Sandbox server (above) only ever reads/writes sandbox data and can never see or affect production, regardless of what the key looks like.

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/expense-management/ocr/process" \  -F file="string" \  -F businessId="string"
{  "success": true,  "extractedFields": {    "isValidAccountingDocument": 0,    "documentNumber": "string",    "documentType": "receipt",    "date": "string",    "supplierName": "string",    "supplierAddress": "string",    "businessNumber": "string",    "amountBeforeVat": 0,    "vatAmount": 0,    "totalAmount": 0,    "currency": "ILS",    "paymentTerms": "string",    "paymentMethod": "string",    "referenceNumber": "string",    "notes": "string",    "paidDate": "string"  },  "items": [    {      "description": "string",      "quantity": 0,      "unitPrice": 0,      "total": 0,      "isIncomeTaxDeductible": true,      "incomeTaxDeductiblePercent": 0,      "isVatDeductible": true,      "vatDeductiblePercent": 0,      "taxCategory": "string",      "taxReason": "string",      "confidence": 0    }  ],  "confidence": {},  "validation": {    "isValid": true,    "missingFields": [      "string"    ],    "invalidFields": [      "string"    ],    "warnings": [      "string"    ],    "requiredUserInput": [      {        "fieldName": "string",        "fieldLabel": "string",        "fieldLabelHebrew": "string",        "fieldType": "text",        "required": true,        "validation": {},        "helperText": "string",        "helperTextHebrew": "string",        "defaultValue": {},        "options": [          "string"        ]      }    ]  },  "visualAnnotations": {    "annotatedImageUrl": "string",    "originalImageUrl": "string",    "annotations": [      {        "fieldName": "string",        "value": "string",        "boundingBox": {          "x": 0,          "y": 0,          "width": 0,          "height": 0,          "isNormalized": true,          "vertices": []        },        "confidence": 0,        "pageNumber": 0,        "color": "string"      }    ]  },  "rawOcrText": "string",  "metadata": {    "processingTime": 0,    "language": "hebrew",    "ocrProvider": "string",    "aiModel": "string",    "processedAt": "string",    "documentType": "string",    "pageCount": 0,    "storageKey": "string",    "originalFileUrl": "string",    "fileStorageId": "string",    "previewImageUrl": "string",    "previewStorageKey": "string",    "previewFileStorageId": "string",    "originalMimeType": "string"  },  "pages": [    {      "pageNumber": 0,      "dimensions": {        "width": 0,        "height": 0,        "unit": "string"      },      "tokens": [        {          "text": "string",          "confidence": 0,          "boundingBox": {            "x": 0,            "y": 0,            "width": 0,            "height": 0,            "isNormalized": true,            "vertices": []          },          "pageNumber": 0,          "type": "block"        }      ],      "lines": [        {          "text": "string",          "confidence": 0,          "boundingBox": {            "x": 0,            "y": 0,            "width": 0,            "height": 0,            "isNormalized": true,            "vertices": []          },          "pageNumber": 0,          "type": "block"        }      ],      "blocks": [        {          "text": "string",          "confidence": 0,          "boundingBox": {            "x": 0,            "y": 0,            "width": 0,            "height": 0,            "isNormalized": true,            "vertices": []          },          "pageNumber": 0,          "type": "block"        }      ]    }  ]}