List Expenses (lawmatics_list-expenses)
List expenses from Lawmatics with optional pagination, filtering, and sorting. Filter by the attached matter/contact id, the associated user id, or expense fields like billable and created_at. Each row carries a `relationships` envelope of to-one {id,type} pointers (the attached matter or contact, staff and creating users, billing expense type, invoice).
Tool Input
pageinteger— Page number (1-based)(> 0)
filterobject— Optional single-field filter; one filter at a time
fieldstringrequired— Field to filter on: contactable_id (numeric id of the matter/contact the expense is attached to), contactable_type (STORED record type — use Prospect for matter-attached and Contact for contact-attached expenses; case-sensitive, and the write-side 'Matter' literal does NOT match), user_id (numeric id of the associated firm user), billable (true/false), description (text), created_at, or updated_at (dates)(enum: "contactable_id", "contactable_type", "user_id", "billable", "description", "created_at", "updated_at")
operatorstring— Comparison operator. Omit to use the Lawmatics per-field default (= for ids/booleans/dates, ilike for strings). Use = for id fields and a range operator (e.g. >) for created_at(enum: "=", "!=", "<", "<=", ">", ">=", "like", "ilike", "null", "not_null")
valuestringrequired— Value to compare against (ignored for null / not_null operators)
sortBystring— Column to sort by(enum: "id", "created_at", "updated_at")
sortOrderstring— Sort direction; ascending or descending(enum: "asc", "desc")
Tool Output
expensesarrayrequired— Expenses on this page of results
[]object
idstringrequired— Unique ID of the expense
descriptionstringnullrequired— Description of the expense; null if unset
costCentsnumbernullrequired— Expense cost in integer cents (e.g. 50000 = $500.00); null if not reported
billablebooleannullrequired— Whether the expense is billable; null if not reported
rateFlatFeebooleannullrequired— Whether the expense is billed as a flat fee; null if not reported
rateCentsnumbernullrequired— Billing rate in integer cents; null if not reported
rateCurrencystringnullrequired— ISO currency code of the billing rate (e.g. USD); null if not reported
durationnumbernullrequired— Duration value as returned by the API (expenses share Lawmatics' time-entry storage model); null if not reported
durationRoundednumbernullrequired— Duration rounded to the firm's billing increment; null if not reported
startedAtstringnullrequired— ISO 8601 timestamp the expense timer started; null if unset or omitted
completedAtstringnullrequired— ISO 8601 timestamp the expense timer completed; null if unset or omitted
createdAtstringnullrequired— When the expense was created, as an ISO 8601 timestamp; null if unknown
updatedAtstringnullrequired— When the expense was last updated, as an ISO 8601 timestamp; null if unknown
relationshipsobjectrequired— To-one JSON:API relationship pointers as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own tool (e.g. type 'user' -> get-user, type 'prospect' -> get-matter, type 'contact' -> get-contact, type 'invoice' -> get-invoice).
5 fields
staffobjectnullrequired— Pointer to the firm user the expense is attributed to; null when unattributed
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
createdByobjectnullrequired— Pointer to the firm user who created the record; null when unattributed
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
expenseTypeobjectnullrequired— Pointer to the billing expense type categorizing this expense; null when uncategorized
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
contactableobjectnullrequired— Pointer to the record the expense is attached to; type is "prospect" for a matter or "contact" for a contact; null when unattached
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
invoiceobjectnullrequired— Pointer to the invoice this expense is billed on; null when uninvoiced
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
paginationobjectrequired— Pagination metadata derived from the API `meta` envelope
totalPagesnumbernullrequired— Total number of pages available; null if not reported
limitPerPagenumbernullrequired— Maximum expenses returned per page; null if not reported
totalEntriesnumbernullrequired— Total number of expenses across all pages; null if not reported
Related Tools