API referenceExpenses
Expense summary
Needs a token with the read:expenses scope (or write:expenses). Authentication
Try in Playground sends a real request to app.helvetly.com with a token you paste. It stays in this browser tab only (session storage) and goes to no one else.
GET
Spending figures in the workspace currency: this and last month, unpaid, overdue, to reimburse, input VAT of the current quarter, incomplete drafts, this month by category and the last 12 months. Void expenses are excluded.
bearerAuthheader
AuthorizationBearer <token>A personal API token, hvt_…, with scopes such as read:* or write:invoices
OK
application/json- response
data*Spending figures in the workspace currency (base amounts), void expenses excluded, by document date.
curl -X GET 'https://app.helvetly.com/api/v1/expenses/summary'Example Response
{ "data": { "currency": "string", "this_month": { "amount": "1234.50", "count": 0 }, "last_month": { "amount": "1234.50", "count": 0 }, "unpaid": { "amount": "1234.50", "count": 0 }, "overdue": { "amount": "1234.50", "count": 0 }, "to_reimburse": { "amount": "1234.50", "count": 0 }, "input_vat": { "period": "string", "amount": "1234.50" }, "incomplete": { "count": 0 }, "by_category": [ { "category": { "id": "string", "name": "string", "account_code": "string" }, "amount": "1234.50" } ], "monthly": [ { "month": "string", "amount": "1234.50" } ], "views": { "review": 0, "unpaid": 0, "reimburse": 0 } }}