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
| Name | In | Type | Description |
|---|---|---|---|
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" use Ledga\Api\LedgaClient;
$ledga = new LedgaClient('sk_xxxxxxxx_your_secret');
$report = $ledga->reports->incomeStatement(['from_date' => '2026-01-01', 'to_date' => '2026-01-31']);