VUZDevelopers

List expenses with filters

GET
/expense-management/expenses

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

Query Parameters

page?number

Page number (1-indexed)

Range1 <= value
Default1
limit?number

Items per page

Range1 <= value <= 100
Default20
sort?string

Sort by field(s). Format: "field:asc" or "field:desc". Multiple: "field1:asc,field2:desc"

q?string

Free-text search query

status?string

Value in

  • "processing"
  • "pending_review"
  • "sent_to_accountant"
  • "in_accountant_review"
  • "approved"
  • "rejected"
  • "reimbursed"
categoryId?string
startDate?string
endDate?string
minAmount?string
maxAmount?string

Response Body

application/json

curl -X GET "https://example.com/expense-management/expenses"
{  "items": [    {      "id": "string",      "businessId": "string",      "description": "string",      "amount": 0,      "vatAmount": 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": "C04_S01",      "parentCategoryCode": "C04",      "receiptNumber": "string",      "currency": "ILS",      "exchangeRate": 3.65,      "totalAmountIls": 731.7,      "importSource": "manual",      "documentType": "string",      "isDuplicate": true,      "duplicateLevel": "none",      "notAdmissibleExpense": true,      "receiptCount": 0,      "ocrMetadata": {},      "metadata": {},      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0}