Create new expense

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

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description*string

Expense description

Lengthlength <= 255

amount*number

Expense amount before VAT

Range0 <= value

vatAmount?number

VAT amount

Range0 <= value

expenseDate*string

Date of expense

Formatdate

categoryId?string

Legacy category ID (per-business). Being retired in favour of categoryCode.

categoryCode?string

Canonical category = global taxonomy LEAF code (e.g. "C18_S16"). Single source of truth for the category.

supplierId?string

Supplier ID

receiptNumber?string

Receipt number

Lengthlength <= 50

tags?array<string>

Tags for categorization

currency?string

Currency code

Default"ILS"

metadata?

Additional metadata

isCreditNote?boolean

Record this as a supplier CREDIT NOTE (זיכוי ספק) instead of a bill: amounts stay positive, the GL legs are inverted (Dr AP / Cr expense + input-VAT reversal) and the supplier AP balance nets down.

Defaultfalse

creditedExpenseId?string

Original supplier bill (expense id) this credit note credits

Formatuuid

Response Body

`application/json`

curl -X POST "https://example.com/expense-management/expenses" \  -H "Content-Type: application/json" \  -d '{    "description": "string",    "amount": 0,    "expenseDate": "2019-08-24"  }'

{  "id": "string",  "businessId": "string",  "userId": "string",  "description": "string",  "amount": 0,  "vatAmount": 0,  "vatRate": 0,  "totalAmount": 0,  "vatRecognitionRate": 1,  "incomeTaxRecognitionRate": 1,  "status": "processing",  "expenseDate": "2019-08-24T14:15:22Z",  "paidDate": "2019-08-24T14:15:22Z",  "categoryId": "string",  "category": {    "id": "string",    "businessId": "string",    "code": "OFFICE_SUPPLIES",    "nameHe": "ציוד משרדי",    "nameEn": "Office Supplies",    "descriptionHe": "string",    "descriptionEn": "string",    "defaultVatRecognitionRate": 1,    "defaultIncomeTaxRecognitionRate": 1,    "icon": "fi-rr-box",    "color": "#3b82f6",    "sortOrder": 0,    "isActive": true,    "isSystem": false,    "rules": {},    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  },  "categoryCode": "C18_S16",  "parentCategoryCode": "C18",  "supplierId": "string",  "receiptNumber": "string",  "currency": "ILS",  "exchangeRate": 3.65,  "totalAmountIls": 731.7,  "importSource": "manual",  "metadata": {},  "ocrMetadata": {},  "aiOriginalExtraction": {},  "isDuplicate": true,  "duplicateLevel": "none",  "duplicateOfId": "string",  "notAdmissibleExpense": true,  "contentHash": "string",  "approvedBy": "string",  "approvedAt": "2019-08-24T14:15:22Z",  "receipts": [    {      "id": "string",      "originalFilename": "string",      "mimeType": "string",      "fileSize": 0,      "storageKey": "string",      "signedUrl": "string",      "ocrData": {},      "ocrProcessedAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "deletedAt": "2019-08-24T14:15:22Z"}

Authorization

Request Body

Response Body

201application/json

400

`application/json`