GET
/
v0
/
reports
/
income-statement

Authorizations

Authorization
string
headerrequired

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

teal-instance-id
string
required

The Teal instance ID

Query Parameters

start_date
string
required

Only include data after the start date (inclusive).

end_date
string
required

Only include data before the end date (inclusive).

tag_ids
string[] | null

Comma-separated list of tag IDs for filtering. Requires a Tier 3 subscription

include_empty
boolean
default: true

Whether to include empty ledgers with no line entries. Only available for Platform GL instances.

Response

200 - application/json
records
object[] | null

A list of Records that represents either a ledger, a groups of ledgers, or a profit metric.

Records that are groups of ledgers are grouped by income statement sub_type: operating_revenues, cost_of_goods_sold, operating_expenses, other_expenses and other_income. Records that are profit metrics calculate total net sales, gross profit, total operating profit, and net profit.

The list of Records will always be returned in the following order:

  • Operating revenue ledgers (group)

  • Total net sales (calculation)

  • Cost of goods sold (group)

  • Gross profit (calculation)

  • Operating expenses (group)

  • Total operating profit (calculation)

  • Other expenses (group)

  • Other income (group)

  • Net profit (calculation)

Within each sub_type group, Ledger objects are ordered by sort_code.