---
title: "Retrieves a paginated list of expense entries with rich filtering by date range, user, project, category, chargeable/invoiced status, approval status, and merchant."
method: GET
path: "/api/Expense"
tags: ["Expense"]
---

# Retrieves a paginated list of expense entries with rich filtering by date range, user, project, category, chargeable/invoiced status, approval status, and merchant.

`GET /api/Expense`

## Query parameters

- `UpdatedAfter` string, date-time
- `ExpenseDateFrom` string, date-time
- `ExpenseDateTo` string, date-time
- `UserEmail` string
- `UserID` integer
- `CategoryName` string
- `CustomerID` integer
- `ProjectID` integer
- `isChargeable` boolean
- `isInvoiced` boolean
- `ExpenseReimbursementIDFK` integer
- `ExpensePaymentMethodIDFK` integer
- `ExpenseApprovalStatusCode` string
- `Search` string
- `pageSize` integer
- `pageNumber` integer
- `Sort` string

## Response `200`

Returns a paginated list of expense entries with full details.

- ExpenseList — Paginated collection of expense entries.
  - `Expenses` ExpenseDetails[] — The list of expense entries for the current page.
    - `ExpenseID` integer — Unique identifier for the expense entry.
    - `UserIDFK` integer — The user ID who created/owns this expense.
    - `Firstname` string — First name of the expense user.
    - `Lastname` string — Last name of the expense user.
    - `Email` string — Email address of the expense user.
    - `CustomerIDFK` integer — The customer/company ID the expense is associated with.
    - `CustomerName` string — Name of the associated customer/company.
    - `ProjectIDFK` integer — The project ID the expense is linked to.
    - `ProjectTitle` string — Title of the associated project.
    - `ProjectCode` string — Short code of the associated project.
    - `TaskIDFK` integer — The task ID the expense is linked to.
    - `TaskTitle` string — Title of the associated task.
    - `ExpenseCategoryIDFK` integer — The expense category ID.
    - `ExpenseCategoryName` string — Name of the expense category.
    - `ExpenseCategoryHasUnitPrice` boolean — Whether the expense category has a predefined unit price (e.g. mileage rate).
    - `ExpenseCategoryUnitPrice` number, double — The unit price for the expense category, if applicable.
    - `ExpenseCategoryUnitName` string — The unit label (e.g. 'miles', 'km') for unit-priced categories.
    - `CurrencyCode` string — ISO 3-character currency code for the expense.
    - `ExchangeRate` number, double — Exchange rate from expense currency to account base currency.
    - `Quantity` number, double — Quantity for unit-priced expenses (e.g. number of miles).
    - `Amount` number, double — The expense amount in the expense currency.
    - `TaxAmount` number, double — Calculated tax amount on the expense.
    - `TaxIDFK` integer — The tax rate ID applied to this expense.
    - `TaxName` string — Name of the applied tax rate.
    - `TransactionTaxConfigCode` string — Tax configuration: 'EX' (exclusive) or 'INC' (inclusive).
    - `TransactionTaxConfigName` string — Display name for the tax configuration.
    - `isOfficialExchangeRate` boolean — Whether the exchange rate is from an official/market source.
    - `ExpenseApprovalStatusCode` string — Approval status. Values: Draft, Pending, Approved, AutoApproved, Rejected, Verified.
    - `ExpensePaymentMethodIDFK` integer — The payment method ID used for this expense.
    - `ExpensePaymentMethodName` string — Name of the payment method.
    - `isChargeable` boolean — Whether the expense is billable to the customer.
    - `ChargeableStatusCode` string — Detailed chargeable status code.
    - `isReimbursable` boolean — Whether the expense is reimbursable to the employee.
    - `ExpenseReimbursementStatusCode` string — Reimbursement processing status.
    - `ExpenseReimbursementIDFK` integer — The reimbursement batch ID this expense belongs to, if reimbursed.
    - `ExpenseDate` string, date-time — The date the expense was incurred.
    - `FileAttachmentIDFK` integer — ID of the receipt/file attachment, if any.
    - `AttachmentURL` string — Public URL of the expense receipt attachment.
    - `AttachmentPreviewURL` string — URL for a preview/thumbnail of the expense attachment.
    - `Merchant` string — Name of the merchant/vendor.
    - `MerchantTaxNumber` string — Tax registration number of the merchant.
    - `Notes` string — Additional notes on the expense.
    - `ExpenseReportIDFK` integer — ID of the expense report/group this expense belongs to.
    - `ExpenseReportName` string — Name of the expense report/group.
    - `DateCreated` string, date-time — Date and time the expense record was created.
    - `DateUpdated` string, date-time — Date and time the expense record was last updated.
    - `ViewExpenseURL` string — Url to view the Expense in Avaza
  - `TotalCount` integer — Total number of expenses matching the filter criteria.
  - `PageNumber` integer — The current page number (1-based).
  - `PageSize` integer — The number of results per page.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)