💰 CoinBandit API Documentation

List all categories, ordered by type and sort_order.

{
  "id": 3,
  "name": "Supermarkt",
  "type": "expense",    // "expense" | "income"
  "emoji": "🛒",
  "sort_order": 3
}

Create a new category.

// Request Body
{
  "name": "Drogerie",
  "type": "expense",
  "emoji": "🧴",
  "sort_order": 4     // optional, default 0
}

Delete a category by ID.

List entries for a month. Returns entries with category info.

// Response
{
  "id": 1371,
  "category_id": 8,
  "amount": "512.00",
  "description": "Flug FRA → Dallas",
  "date": "2026-03-15",
  "recurring": false,
  "tags": ["Polynesien 2026"],
  "category_name": "Urlaub",
  "category_type": "expense",
  "category_emoji": "🏖️"
}

Create a new entry.

// Request Body
{
  "category_id": 8,           // required — category ID
  "amount": 512.00,           // required — positive number
  "description": "Flug FRA",  // optional
  "date": "2026-03-15",       // optional, default today
  "recurring": false,          // optional, default false
  "tags": ["Polynesien 2026"] // optional, string array
}

Update an entry. All fields optional — only provided fields are changed.

// Request Body (all optional)
{
  "amount": 520.00,
  "description": "Flug korrigiert",
  "category_id": 3,
  "date": "2026-03-16",
  "tags": ["Reise", "Flug"]
}

Delete an entry by ID.

Get spending/income breakdown by category.

Parameters:

• period=month&month=YYYY-MM — single month
• period=year&year=YYYY — full year
• period=all — all time

// Response
{
  "categories": [
    { "type": "expense", "category": "Supermarkt", "emoji": "🛒", "total": "175.34", "count": "4" },
    { "type": "income", "category": "Gehälter", "emoji": "💼", "total": "7340.00", "count": "4" }
  ],
  "topDescriptions": [ ... ]
}

Get monthly totals (total income, total expenses, balance).

List all bank accounts.

{
  "name": "Sparda Hauptkonto",
  "bank": "Sparda-Bank Hamburg",
  "emoji": "🏦",
  "initial_balance": 5000,
  "is_default": true
}

Update account. Fields: name, bank, emoji, current_balance, is_default.

Delete account. Entries linked to it will have account_id set to NULL.

List API keys for the authenticated user. Requires session cookie auth (management endpoint).

Generate a new API key. Requires session cookie auth.

{ "name": "My App Key" }