List Expenses

get

https://api.ewitypos.com/apps-v1/expenses

Lists the company's expenses, newest first (ordered by id descending by default). Supports pagination, ordering and q_* filters. Requires the read-expenses permission.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

page

integer

Defaults to 1

Page number.

limit

integer

Defaults to 20

Items per page.

no_paginate

integer

enum

Set to 1 to return all rows without the pagination envelope key.

Allowed:

order_by

string

Ordering as field or field:asc/field:desc (a bare field orders descending). Orderable fields: id, amount, created_at, date, description, outstanding_amount.

q_q

string

Free-text search across description, vendor and bill number.

q_category

string

Filter by expense category id. Comma-separate for multiple, e.g. 3244,119.

q_date

string

Filter by expense date range as Y-m-d,Y-m-d, e.g. 2026-08-01,2026-08-31.

q_status

string

enum

Filter by payment status. unpaid matches any expense with an outstanding amount (including overdue ones); overdue narrows to unpaid expenses past their payment due date.

Allowed:

Headers

X-Ewity-Store

string

required

The merchant install this request acts on (install.store_id from the app.installed webhook).

Response

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Paginated expenses.