API reference

Workspace

List categories

GET

Expense categories for the workspace. Requires workspace:read.

curl "https://api.invoi.st/v1/categories" \
  -H "Authorization: Bearer $INVOIST_API_KEY"

Response · 200

JSON

{ "categories": [] }

GET

Aggregate document and review counts. Requires stats:read.

curl "https://api.invoi.st/v1/stats/overview" \
  -H "Authorization: Bearer $INVOIST_API_KEY"

Response · 200

JSON

123456{
  "documents_this_month": 12,
  "documents_total": 40,
  "pending_review_count": 2,
  "period_start": "2026-08-01T00:00:00Z"
}