API referenceExpenses
List expense categories
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
The workspace's expense categories (each mapped to an account code), by account code; the Swiss KMU defaults are created on first use. Use an id as category_id on an expense. Creating and editing categories is a settings task in the app and not part of the public API.
bearerAuthheader
AuthorizationBearer <token>A personal API token, hvt_…, with scopes such as read:* or write:invoices
include_archived?"1"1: also archived categories.
Value in
"1"OK
application/json- response
data*array<>curl -X GET 'https://app.helvetly.com/api/v1/expense-categories'Example Response
{ "data": [ { "id": "string", "name": "string", "account_code": "string", "is_archived": true, "expenses_count": 0 } ]}