Profit and loss
API Documentation / Resources / Reports

Get a profit and loss report
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/reports/profit-and-loss
Required OAuth scope: reports:read
Returns posted income and expense activity for an inclusive reporting period in the subsidiary's functional currency.
Reporting controls
| Parameter | Meaning | Default |
|---|---|---|
basis |
Accrual or settlement-based cash projection | accrual |
periods |
Number of comparison periods, from 1 to 36 | One period |
timeframe |
Calendar or financial comparison interval | Requested range |
year_to_date |
Add the current year-to-date comparison | false |
last_year_to_date |
Add the prior year-to-date comparison | false |
timeframe is required when periods is supplied. Cash basis is a
reporting projection over posted settlements; it does not create a
second ledger.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose ledger is reported. |
from_date |
query | Yes | string (date) | |
to_date |
query | Yes | string (date) | |
basis |
query | No | string: accrual, cash | |
periods |
query | No | integer | |
timeframe |
query | No | string: month, quarter, financial_quarter, year, financial_year, range | |
year_to_date |
query | No | boolean | |
last_year_to_date |
query | No | boolean |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/reports/profit-and-loss HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
Profit and loss report. |
400 |
A required exchange rate or report input is unavailable. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks reports:read or the granted accounting context. |
404 |
A requested subsidiary, account, contact, or bank account is not available in the grant. |
422 |
One or more report parameters failed validation. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"report": "profit_and_loss",
"basis": "accrual",
"from_date": "2026-07-01",
"to_date": "2026-07-31",
"currency_code": "NZD",
"rows": [
{
"label": "Revenue",
"amount": "84250.0000"
},
{
"label": "Expenses",
"amount": "-52640.0000"
},
{
"label": "Net profit",
"amount": "31610.0000"
}
],
"generated_at": "2026-08-10T17:00:00Z"
}
}