Skip to Content
HelvetlyDocs
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
/api/v1/expense-categories

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.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A personal API token, hvt_…, with scopes such as read:* or write:invoices

Query Parameters

include_archived?"1"

1: also archived categories.

Value in"1"

Response Body

OK

application/json
  1. response
data*array<>
Example Request
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    }  ]}