Ledga
GET /reports/income-statement

Get income statement report

Each revenue and expense system account's net movement on its normal side, one line per type for customer accounts, and net income, from the start of from_date to the end of to_date in the ledger's timezone. Counts every balance-bearing posting (posted or reversed) in the requested layer, effective in that window. Active accounts are always listed; inactive or deleted ones only when something reached them, and their postings always count. Amounts are major-unit strings at the ledger's display precision.

Parameters

NameInTypeDescription
from_daterequired query string
date
First day of the period, from its start in the ledger's timezone
to_daterequired query string
date
Last day of the period, to its end in the ledger's timezone
layer query string
enum: settled | pending | encumbrance · default: "settled"
Transaction layer to report on

Responses

200Income statement report
{
  "success": true,
  "data": {
    "ledger_id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
    "ledger_name": "string",
    "currency": "GBP",
    "from_date": "2026-01-15",
    "to_date": "2026-01-15",
    "layer": "settled",
    "revenue": {
      "accounts": [
        {
          "id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
          "code": "4000",
          "name": "Sales",
          "type": "revenue",
          "normal_balance": "debit",
          "amount": "110.00"
        }
      ],
      "customer_accounts_rollup": {
        "count": 0,
        "amount": "0.00"
      },
      "total": "110.00"
    },
    "expenses": {
      "accounts": [
        {
          "id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
          "code": "4000",
          "name": "Sales",
          "type": "revenue",
          "normal_balance": "debit",
          "amount": "110.00"
        }
      ],
      "customer_accounts_rollup": {
        "count": 0,
        "amount": "0.00"
      },
      "total": "110.00"
    },
    "net_income": "106.00"
  }
}
401Unauthenticated
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}
403Forbidden
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}
422Validation error
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}
429Report rate limit exceeded (30 a minute per API key, 120 per ledger)
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}

Examples

curl https://ledga.io/api/v1/reports/income-statement?from_date=2026-01-15&to_date=2026-01-15 \
  -H "Authorization: Bearer sk_xxxxxxxx_your_secret"

← All endpoints