Account · ExpCateg

API keys

An API key lets another app or service read your categorized transactions (read-only) for a date range. It can't import, change or delete anything. Keep keys secret, and revoke any you no longer use.

Name	Key	Created	Last used

Using the API

Send the key in an Authorization: Bearer header. from and to are inclusive dates (YYYY-MM-DD), both optional; add type=expense or type=income to get only one kind.

The response is JSON: a summary (total income, expenses, net, and totals per category, with refunds deducted from their expense category, same as the Breakdown chart) followed by every matching transaction. Amounts are in RON; a transaction's amount is negative for an expense and positive for income.

{
  "from": "2026-09-01",
  "to": "2026-09-30",
  "currency": "RON",
  "summary": {
    "income": 8500,
    "expenses": 3120.45,
    "net": 5379.55,
    "expensesByCategory": { "Groceries": 1250.3, "Transport": 410 },
    "incomeByCategory": { "Salary": 8500 }
  },
  "count": 1,
  "transactions": [
    {
      "id": "1234",
      "date": "2026-09-14",
      "description": "POS KAUFLAND ...",
      "merchant": "Kaufland",
      "type": "expense",
      "amount": -182.4,
      "category": "Groceries",
      "filedAsRefund": false
    }
  ]
}