Reference
Reports
P&L, Balance Sheet, Trial Balance, Cash Flow, AR/AP aging, Dashboard summary. All read-only.
Reports are read-only aggregations computed on demand from your journal
entries and COA balances. Every report takes businessId and, where
applicable, a date range.
Profit & Loss
/v1/reports/profit-lossRevenue, cost of sales, operating expenses, and net income for a date range.
Query parameters
| Field | Type | Required | Notes |
|---|---|---|---|
businessId | string | yes | |
startDate | ISO 8601 | yes | Inclusive. |
endDate | ISO 8601 | yes | Inclusive. |
Response — 200
{
"success": true,
"data": {
"period": {
"startDate": "2026-01-01",
"endDate": "2026-03-31"
},
"revenue": { "total": 3_250_000, "totalKobo": 325_000_000, "accounts": [...] },
"costOfSales": { "total": 0, "accounts": [] },
"grossProfit": { "total": 3_250_000 },
"operatingExpenses": { "total": 1_180_000, "accounts": [...] },
"netIncome": { "total": 2_070_000, "totalKobo": 207_000_000 }
}
}Balance Sheet
/v1/reports/balance-sheetAssets, liabilities, and equity as of a point in time.
Query parameters
| Field | Type | Required | Notes |
|---|---|---|---|
businessId | string | yes | |
asOfDate | ISO 8601 | no | Defaults to today. |
Trial Balance
/v1/reports/trial-balanceEvery ledger account with debit/credit balance. Must net to zero.
Query parameters
| Field | Type | Required |
|---|---|---|
businessId | string | yes |
Cash Flow
/v1/reports/cash-flowOperating, investing, and financing activity for a date range.
Query parameters
| Field | Type | Required |
|---|---|---|
businessId | string | yes |
startDate | ISO 8601 | yes |
endDate | ISO 8601 | yes |
Dashboard Summary
/v1/reports/dashboardOne-shot snapshot: cash position, AR/AP totals, MTD revenue, recent activity. Useful for building dashboards that show the same numbers as Finora Business's own.
Query parameters
| Field | Type | Required |
|---|---|---|
businessId | string | yes |
AR Aging
/v1/reports/ar-agingOutstanding receivables bucketed by age (current, 1–30, 31–60, 61–90, 90+).
AP Aging
/v1/reports/ap-agingOutstanding payables bucketed by age.
Tax Compliance
/v1/reports/tax-complianceNigerian tax compliance status per tax type (VAT, WHT, CIT, PAYE). Paired with the tax module.
Tax Summary
/v1/reports/tax-summaryTax amounts due/paid for a date range.
Query parameters
| Field | Type | Required |
|---|---|---|
businessId | string | yes |
startDate | ISO 8601 | yes |
endDate | ISO 8601 | yes |
Related endpoints
- Tax & Compliance — more detailed tax endpoints
- Documents — export reports as PDF or Excel
Reference index
Back to all modules