finov.ioDocumentationHome

Profit and loss

API Documentation / Resources / Reports

Finovio profit and loss report showing account balances for the selected period
Select an account balance to inspect its supporting transactions.

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"
  }
}