Commercial Edition

REST API Reference

Direct, headless JSON endpoints for external automation, mobile clients, and script integrations.

Base URL: /api/...
ACCOUNTS
Chart of Accounts Endpoints
GET /api/accounts

Retrieve all accounts with individual balances and subtree totals.

curl -X GET "http://localhost:5000/api/accounts?includeInactive=false"
GET /api/accounts/tree

Retrieve hierarchical tree of accounts with nested sub-accounts.

POST /api/accounts

Create a new account with custom code, name, type, and optional parent.

{
  "code": "1015",
  "name": "High Yield Savings",
  "type": "Asset",
  "parentAccountId": 1,
  "currency": "USD"
}
PUT /api/accounts/{id}

Update account code, name, parent or active status.

DELETE /api/accounts/{id}

Delete an account (fails safely if transactions or subaccounts exist).

TRANSACTIONS
Journal Entries & Quick Operations
GET /api/journal-entries

Query journal entries with optional date range, account ID filter, and text search.

POST /api/journal-entries

Record a multi-line double-entry journal (validates Debits == Credits).

{
  "date": "2026-09-16",
  "description": "Office Supplies",
  "reference": "INV-1092",
  "lines": [
    { "accountId": 25, "debit": 150.00, "credit": 0 },
    { "accountId": 3, "debit": 0, "credit": 150.00 }
  ]
}
POST /api/journal-entries/transfer

Perform single-operation fund transfer or liability payoff.

{
  "fromAccountId": 3,
  "toAccountId": 4,
  "amount": 500.00,
  "description": "Transfer to Emergency Fund"
}
POST /api/journal-entries/quick

Quick income receipt or expense record without debit/credit knowledge.

POST /api/journal-entries/{id}/void

Mark a journal entry voided while retaining the immutable audit history.

REPORTS
Financial Statements Endpoints
GET /api/reports/dashboard

Returns Net Worth, Total Assets, Total Liabilities, YTD Net Income, and Top Holdings.

GET /api/reports/balance-sheet?asOfDate=2026-09-16

Assets, Liabilities, Equity, and Retained Earnings.

GET /api/reports/income-statement?fromDate=2026-01-01&toDate=2026-12-31

Revenues, Expenses, and Net Income.

GET /api/reports/trial-balance?asOfDate=2026-09-16

Auditing matrix of debits vs credits for all active accounts.

GET /api/reports/ledger/{accountId}

General ledger line-by-line running balance for a specific account.

API Specifications
  • Content-Type: application/json
  • Database: SQLite local file storage
  • Standard: Double-entry bookkeeping rule (Σ Debits = Σ Credits)
  • Enums: Serialized as string names (e.g. "Asset", "Posted")
Built-in Features

The API is powered by ASP.NET Core with Entity Framework Core, providing high throughput, ACID transactional consistency, and relational integrity.

You can call these endpoints from Python, PowerShell, cURL, frontend frameworks, or mobile clients.

AGMyAccount © 2026 • Developed by Owl Technologies, Belize 🇧🇿
About & Team