Expenses

List the token's own user's expenses

Cursor-paginated, scoped to the token's account and role. The token's own user's expenses, including unsubmitted drafts. Unlike /v1/expenses, not bounded by the role's expense visibility.

Besides the filter[<field>_<predicate>] fields, these filters take a plain value:

  • filter[archived] — false (default) hides archived expenses, true returns only archived ones, all returns both.
get/v1/me/expenses

Request

  • Base URL: https://api.topkey.io
  • URL: https://api.topkey.io/v1/me/expenses
  • Auth: HTTP bearer

Query parameters

page[size]integer

Rows per page (max 100).

page[after]string

Opaque cursor from the previous page's meta.next_cursor.

archivedstring

false (default) hides archived expenses, true returns only archived ones, all returns both.

filter[field_predicate]=value (Ransack, per-resource allowlist), and the plain-value filters listed. Unknown filters return 400. Filterable fields: accounting_sync_status, approval_status, bill_id, category, created_at, date, expensable_type, gl_code_id, id, property_id, state, submitted_at, updated_at.

Comma-separated relationships to sideload into included.

Response

A page of expenses.

Changes

No recorded changes to this operation across all 1 revision of this API.