GET
/
v0
/
reports
/
top-expenses
curl --request GET \
  --url https://api.sandbox.teal.dev/v0/reports/top-expenses \
  --header 'Authorization: Bearer <token>' \
  --header 'teal-instance-id: <teal-instance-id>'
{
  "entries": [
    {
      "ledger_amount": 182521.96,
      "ledger_id": "Qm6MjL7pKRPhoUD3dZsPH1",
      "ledger_name": "Contract Labor Expense",
      "percent_total": 56.85
    },
    {
      "ledger_amount": 44809.92,
      "ledger_id": "GDKCCTVMjrAb6FUDBJPUB4",
      "ledger_name": "Cost Of Goods Sold",
      "percent_total": 13.96
    },
    {
      "ledger_amount": 36256.44,
      "ledger_id": "AfnWQVE4iXuNd91iyceCJt",
      "ledger_name": "Advertising Expense",
      "percent_total": 11.29
    },
    {
      "ledger_amount": 26400,
      "ledger_id": "BdEdx5xFGAWcwuwdtFGHpS",
      "ledger_name": "Rent Expense",
      "percent_total": 8.22
    },
    {
      "ledger_amount": 25727.86,
      "ledger_id": "LxokBiGqsNk9Yu3sLgFWz8",
      "ledger_name": "Gas and Auto Expense (Vehicle Expense)",
      "percent_total": 8.01
    }
  ]
}

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).

limit
integer
required

The number of results to return

tag_ids
string

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

Response

200 - application/json
entries
object[]
required

A list of the top highest expense type ledgers within the period.

List cash flow totals by ledgerList net profit by period