Expenses
List expenses
Returns the user's expenses, sorted by date descending.
Optional filters (combinable):
- status=paid or status=unpaid — filter by payment status
- year=YYYY — only expenses whose date falls in the given calendar year (UTC)
Any other query parameter returns a 400. Filter on additional fields (e.g. categoryID) client-side.
get/expenses
Request
- Base URLhttps://api.vocal.email/v1
- Auth
- API key in header X-API-Key
- or HTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
status'paid' | 'unpaid'
Filter by payment status.
yearinteger
Filter expenses whose date falls in the given Swiss (Europe/Zurich) calendar year, as the app shows it.
Changes
No recorded changes to this operation across all 5 revisions of this API.