API reference

Reports

The financial statements, burn and runway, and spend by department.

GET/v1/reports/1099Get what each vendor was paid for their 1099
GET/v1/reports/agingGet receivables or payables by age
GET/v1/reports/balance_historyGet assets, liabilities and net assets over time
GET/v1/reports/balance_sheetGet the balance sheet
GET/v1/reports/burnGet burn and runway
GET/v1/reports/cash_flowGet the cash flow statement
GET/v1/reports/consolidationGet the organization's consolidated balance sheet and income statement
GET/v1/reports/income_statementGet the income statement
GET/v1/reports/spend_by_departmentGet operating expenses by department
GET/v1/reports/tax_linesGet the books by tax line for a fiscal year
GET/v1/reports/trial_balanceGet the trial balance
GET/v1/reports/upcoming_billsList the bills coming due

Guides: Read your dashboard, Read and export reports, Read your group's consolidated statements

Get what each vendor was paid for their 1099

GET/v1/reports/1099

client.reports.form1099()

What each 1099-eligible vendor was paid in a calendar year, against the year's filing threshold ($600 through 2025, $2,000 from 2026), and whether their W-9 and tax id are on file. Money paid by card is left out: the card network reports it. Turn eligible_only off to see every other vendor paid the threshold, who may need marking.

Parameters

Name	Type	Description
`year`Query	integer or null	The calendar year; last year when left out.
`eligible_only`Query	boolean	Only vendors marked 1099-eligible. Off, every other vendor paid the threshold is listed too. Default true

Response

200Form1099YearOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/1099" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get receivables or payables by age

GET/v1/reports/aging

client.reports.aging()

Receivables (or payables) on a day, by counterparty and by how far past due: not yet due, 1–30, 31–60, 61–90 and over 90 days. A payment not yet applied counts against its party in current.

Parameters

Name	Type	Description
`ledger`Query	string	`ar` for receivables, `ap` for payables. Default ar
`as_of`Query	string (date) or null	The day; today when left out.

Response

200AgingOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/aging" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get assets, liabilities and net assets over time

GET/v1/reports/balance_history

client.reports.balanceHistory()

Total assets, total liabilities and net assets at each date from since to until, and every asset and liability account's balance at the same dates, grouped under its top-level account. Each point equals the balance sheet's totals as of that date. The history never starts before the books' first entry: since is moved up to it.

Parameters

Name	Type	Description
`since`Query	string (date) or null	First day. Defaults to the day the books start.
`until`Query	string (date) or null	Defaults to today.
`interval`Query	string or null	One point per day, or per week or month end (the last point is always `until`). At most 1000 points. Defaults to the finest interval that fits. One of `day`, `week`, `month`

Response

200BalanceHistoryOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/balance_history" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get the balance sheet

GET/v1/reports/balance_sheet

client.reports.balanceSheet()

Assets, liabilities and equity as of as_of (today by default). Both sides are computed independently and any difference is reported.

Parameters

Name	Type	Description
`as_of`Query	string (date) or null	Defaults to today.

Response

200BalanceSheetOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/balance_sheet" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get burn and runway

GET/v1/reports/burn

client.reports.burn()

Cash, gross and net burn by month, and runway: cash divided by the average net burn of the last three complete months. Transfers between the company's own accounts, money raised and equipment bought are not burn.

Parameters

Name	Type	Description
`as_of`Query	string (date) or null	Defaults to today.
`months`Query	integer	How many months of burn to return, the current month included. Default 6

Response

200BurnAndRunwayOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/burn" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get the cash flow statement

GET/v1/reports/cash_flow

client.reports.cashFlow()

The indirect cash flow statement between since and until (this month to date by default): net income, then operating, investing and financing movements, reconciled to what the cash accounts did.

Parameters

Name	Type	Description
`since`Query	string (date) or null	Defaults to the start of this month.
`until`Query	string (date) or null	Defaults to today.

Response

200CashFlowStatementOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/cash_flow" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get the organization's consolidated balance sheet and income statement

GET/v1/reports/consolidation

client.reports.consolidation()

The organization's consolidated balance sheet and income statement, in these books' currency.

Each set of books is read from its own ledger, translated (balance sheet at the closing rate, income and expense at the period's average, from these books' rates) and added up by account code; intercompany balances between them are eliminated. Refused with consolidation_refused when the organization has books you cannot open, a currency has no rate in these books, or for an API key, which reaches only its own books.

Parameters

Name	Type	Description
`as_of`Query	string (date) or null	The balance sheet date. Defaults to today.
`start`Query	string (date) or null	The first day of the income statement. Defaults to the fiscal year's.

Response

200ConsolidationOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/consolidation" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get the income statement

GET/v1/reports/income_statement

client.reports.incomeStatement()

Revenue, cost of revenue, gross profit, operating expenses by function and net income between since and until (this month to date by default).

Parameters

Name	Type	Description
`since`Query	string (date) or null	Defaults to the start of this month.
`until`Query	string (date) or null	Defaults to today.

Response

200IncomeStatementOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/income_statement" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get operating expenses by department

GET/v1/reports/spend_by_department

client.reports.spendByDepartment()

Operating expenses by department between since and until (this month to date by default), payroll included: what each team spent, and what names no team yet.

Parameters

Name	Type	Description
`since`Query	string (date) or null	Defaults to the start of this month.
`until`Query	string (date) or null	Defaults to today.

Response

200SpendByDepartmentOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/spend_by_department" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get the books by tax line for a fiscal year

GET/v1/reports/tax_lines

client.reports.taxLines()

The books by Form 1120 line for a fiscal year: page 1 from the year's income and expense, Schedule L from the balances at its start and end (this year's unclosed result in retained earnings), and Schedule M-1's book income tax. Each line lists its accounts.

Parameters

Name	Type	Description
`fiscal_year`Query	integer or null	The calendar year the fiscal year ends in; the current one when left out.

Response

200TaxReportOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/tax_lines" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Get the trial balance

GET/v1/reports/trial_balance

client.reports.trialBalance()

Every account's debit or credit balance as of as_of (today by default). The two columns are equal when the ledger is sound; if not, the difference is reported, never plugged.

Parameters

Name	Type	Description
`as_of`Query	string (date) or null	Defaults to today.

Response

200TrialBalanceOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/trial_balance" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

List the bills coming due

GET/v1/reports/upcoming_bills

client.reports.upcomingBills()

The bills coming due in the next days days: what is still owed on the bills the books hold, by due date, and the bills each vendor's rhythm says are coming (monthly, quarterly or yearly), at their usual amount. Overdue bills and late expected ones come first. A bill well over its vendor's usual says by how much.

Parameters

Name	Type	Description
`days`Query	integer	How many days ahead to look, today included. Default 90

Response

200UpcomingBillsOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reports/upcoming_bills" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Objects

The objects these operations take and return.

Form1099YearOut

Name	Type	Description
`currency`Required	string
`threshold`Required	string	The year's filing threshold for a 1099-NEC or 1099-MISC.
`vendors`Required	array of VendorYearOut
`year`Required	integer

AgingOut

Name	Type	Description
`as_of`Required	string (date)
`control_balance`Required	string	The control accounts' balance from lines that name a party, on the owed side: the aging's total equals it.
`ledger`Required	string
`rows`Required	array of AgingRowOut
`totals`Required	AgingRowOut	Every party together; `party_id` is null.

BalanceHistoryOut

Name	Type	Description
`currency`Required	string
`groups`Required	array of BalanceHistoryGroupOut
`interval`Required	string
`points`Required	array of BalancePointOut
`since`Required	string (date)
`until`Required	string (date)

BalanceSheetOut

Name	Type	Description
`as_of`Required	string (date)
`assets`Required	BalanceSheetSectionOut
`balanced`Required	boolean
`currency`Required	string
`difference`Required	string
`equity`Required	BalanceSheetSectionOut
`liabilities`Required	BalanceSheetSectionOut
`total_assets`Required	string
`total_liabilities_and_equity`Required	string

BurnAndRunwayOut

Name	Type	Description
`as_of`Required	string (date)	The day the figures are read as of.
`burning`Required	boolean	True when the trailing net burn is above zero.
`cash`Required	string	Cash across every cash account at the end of `as_of`.
`currency`Required	string	The books' currency, as an ISO 4217 code.
`months`Required	array of BurnMonthOut	Oldest first; the last is the current month to date.
`runway_months`Required	string or null	Months of cash at the trailing net burn, to one decimal. Null when the company is not burning.
`trailing_months`Required	integer	How many complete months `trailing_net_burn` averages.
`trailing_net_burn`Required	string or null	Average net burn of the last complete months (up to three), or null with no complete month yet.

CashFlowStatementOut

Name	Type	Description
`balanced`Required	boolean
`beginning_cash`Required	string
`currency`Required	string
`difference`Required	string
`ending_cash`Required	string
`net_change`Required	string
`net_income`Required	string
`sections`Required	array of CashFlowSectionOut
`since`Required	string (date)
`until`Required	string (date)

ConsolidationOut

Name	Type	Description
`as_of`Required	string (date)
`balance_sheet`Required	array of ConsolidatedLineOut	Assets, liabilities, then equity, on `as_of`.
`balanced`Required	boolean	Whether assets equal liabilities and equity. False is a defect to show.
`currency`Required	string	The presenting currency: these books' own.
`eliminations`Required	array of EliminationOut
`entities`Required	array of ConsolidatedEntityOut	Every set of books of the organization, these first.
`income_statement`Required	array of ConsolidatedLineOut	Income, then expense, from `start` to `as_of`.
`net_income`Required	string
`start`Required	string (date)
`total_assets`Required	string
`total_equity`Required	string
`total_liabilities`Required	string

IncomeStatementOut

Name	Type	Description
`cost_of_revenue`Required	string
`currency`Required	string
`gross_margin`Required	string or null
`gross_profit`Required	string
`net_income`Required	string
`operating_expenses`Required	string
`operating_income`Required	string
`other_expense`Required	string
`other_income`Required	string
`revenue`Required	string
`sections`Required	array of IncomeSectionOut
`since`Required	string (date)
`until`Required	string (date)

SpendByDepartmentOut

Name	Type	Description
`currency`Required	string
`departments`Required	array of DepartmentSpendOut	Every department, by code, spent or not.
`since`Required	string (date)
`total`Required	string	Every operating expense in the window.
`unassigned`Required	string	Operating expenses naming no department.
`until`Required	string (date)

TaxReportOut

Name	Type	Description
`beginning_total_assets`Required	string
`beginning_total_liabilities_and_equity`Required	string
`income_per_books`Required	string	Page 1's income less its deductions, before income tax.
`lines`Required	array of TaxReportLineOut
`since`Required	string (date)
`total_assets`Required	string	Schedule L at the year's end.
`total_liabilities_and_equity`Required	string
`until`Required	string (date)

TrialBalanceOut

Name	Type	Description
`as_of`Required	string (date)
`balanced`Required	boolean
`currency`Required	string
`difference`Required	string
`rows`Required	array of TrialBalanceRowOut
`total_credits`Required	string
`total_debits`Required	string

UpcomingBillsOut

Name	Type	Description
`as_of`Required	string (date)
`billed_total`Required	string	What is owed on the bills the books hold.
`bills`Required	array of UpcomingBillOut	Soonest first, overdue and late ones at the top.
`currency`Required	string	The books' currency. Bills in any other currency are left out.
`expected_total`Required	string	The bills expected from vendors' rhythms, not in yet.
`through`Required	string (date)	The last day the list covers.
`total`Required	string	Every bill on the list.

VendorYearOut

Name	Type	Description
`counterparty_id`Required	string	An id that starts with `party_`.
`form_1099_category`Required	string or null	`nec` or `misc`; null when not chosen. One of `nec`, `misc`
`is_1099_eligible`Required	boolean	Marked 1099-eligible on their vendor role.
`name`Required	string
`needs_w9`Required	boolean	1099-eligible, over the threshold, and no W-9 on file.
`over_threshold`Required	boolean	Paid at least the year's filing threshold.
`paid`Required	string	Paid in the year in the books' currency, by bank and recorded payments, less refunds; card payments are left out (they go on a 1099-K).
`tax_id_on_file`Required	boolean	A tax id is recorded for them. The id itself is never returned here.
`w9_received_on`Required	string (date) or null	When their W-9 was collected, or null.
`w9_requested_at`Required	string (date-time) or null	When a W-9 was asked of them by email and is still awaited, or null.

AgingRowOut

Name	Type	Description
`current`Required	string	Not yet due, and payments not yet applied.
`days_1_30`Required	string
`days_31_60`Required	string
`days_61_90`Required	string
`over_90`Required	string
`party_id`Required	string or null	An id that starts with `party_`.
`party_name`Required	string or null
`total`Required	string

BalanceHistoryGroupOut

Name	Type	Description
`account_id`Required	string	The top-level account the group is named for.
`accounts`Required	array of BalanceHistoryAccountOut	Every account in the group that held a balance at any point.
`balances`Required	array of string	The group's total at each point, in the order of `points`.
`code`Required	string
`name`Required	string
`type`Required	string	`asset` or `liability`.

BalancePointOut

Name	Type	Description
`assets`Required	string	Total assets at the end of `date`.
`date`Required	string (date)	The day this point is the balance sheet as of.
`liabilities`Required	string	Total liabilities at the end of `date`.
`net_assets`Required	string	Assets less liabilities: equity plus earnings not yet closed.

BalanceSheetSectionOut

Name	Type	Description
`lines`Required	array of BalanceSheetLineOut
`total`Required	string

BurnMonthOut

Name	Type	Description
`complete`Required	boolean	False for the current month, which is month to date.
`gross_burn`Required	string	Operating cash that left in the month, as a positive figure.
`month`Required	string (date)	The first day of the month.
`net_burn`Required	string	Gross burn less operating inflows. Positive means more went out than came in.
`operating_inflows`Required	string	Operating cash that came in during the month, as a positive figure.

CashFlowSectionOut

Name	Type	Description
`key`Required	string
`lines`Required	array of CashFlowLineOut
`name`Required	string
`total`Required	string

ConsolidatedLineOut

Name	Type	Description
`amounts`Required	array of string	Translated, one per set of books in `entities` order, on the line's natural side.
`code`Required	string or null	The account code the line adds up across the books; null for an added line.
`eliminations`Required	string	What eliminating intercompany balances took off the line.
`key`Required	string or null	For a line consolidation adds rather than an account: `earlier_earnings`, `net_income`, `translation_adjustment` or `intercompany_difference`. One of `earlier_earnings`, `net_income`, `translation_adjustment`, `intercompany_difference`
`name`Required	string
`total`Required	string	The amounts plus the eliminations: the consolidated figure.
`type`Required	string	`asset`, `liability`, `equity`, `income` or `expense`.

EliminationOut

Name	Type	Description
`description`Required	string
`due_from`Required	string	What came off the due-from, translated.
`due_to`Required	string	What came off the due-to, translated.
`transaction_date`Required	string (date)
`transaction_id`Required	string	The intercompany transaction.

ConsolidatedEntityOut

Name	Type	Description
`average_rate`Required	string	The mean rate over the period: what its income and expense are translated at.
`closing_rate`Required	string	One unit of its currency in the presenting currency on `as_of`: what its balance sheet is translated at. 1 for books in the presenting currency.
`currency`Required	string	The currency the set of books keeps.
`id`Required	string	An id that starts with `ent_`.
`name`Required	string

IncomeSectionOut

Name	Type	Description
`groups`Required	array of IncomeGroupOut
`key`Required	string
`name`Required	string
`total`Required	string

DepartmentSpendOut

Name	Type	Description
`amount`Required	string	Operating expenses naming this department itself.
`code`Required	string	The department value's code, e.g. RD.
`name`Required	string
`parent_id`Required	string or null	An id that starts with `dimv_`.
`total`Required	string	This department and every department under it.
`value_id`Required	string	An id that starts with `dimv_`.

TaxReportLineOut

Name	Type	Description
`accounts`Required	array of TaxReportAccountOut
`amount`Required	string	Positive on the line's normal side: the year's activity, or its closing balance.
`beginning`Required	string	Schedule L only: the balance at the start of the year.
`key`Required	string
`label`Required	string
`part`Required	string

TrialBalanceRowOut

Name	Type	Description
`account_id`Required	string	An id that starts with `gla_`.
`code`Required	string
`credit`Required	string
`debit`Required	string
`name`Required	string
`type`Required	string

UpcomingBillOut

Name	Type	Description
`above_usual`Required	string or null	How much a bill comes to over the vendor's usual bill, when it is at least 1.25× it: worth a look before it is paid.
`amount`Required	string	What is due, in the books' currency: what is still owed on a bill, or the vendor's usual bill.
`bill_id`Required	string or null	An id that starts with `bill_`.
`bill_status`Required	string or null	The bill's status: draft or approved.
`counterparty_id`Required	string	The vendor.
`counterparty_name`Required	string
`due_on`Required	string (date)	When its money is due: a bill's due date; for an expected one, the day it usually lands, plus the vendor's payment terms when it sends bills.
`every_months`Required	integer or null	Months between the vendor's bills, when it keeps a rhythm: 1, 3, 12.
`kind`Required	string	`bill`: a bill the books hold, and what is still owed on it. `expected`: one the vendor's billing rhythm says is coming, at its usual amount.
`late`Required	boolean	A bill past its due date and not paid, or an expected one whose usual day has passed without it.
`logo_url`Required	string or null	The vendor's logo, when it has one.
`usual_amount`Required	string or null	When the vendor keeps a rhythm: for an expected bill, what its bill usually comes to; for a bill in, what that bill is measured against, the higher of the vendor's bills before it in its rhythm.
`vendor_number`Required	string or null	The vendor's own number for the bill.

BalanceHistoryAccountOut

Name	Type	Description
`account_id`Required	string	An id that starts with `gla_`.
`balances`Required	array of string	The account's balance at each point, in the order of `points`.
`code`Required	string
`name`Required	string

BalanceSheetLineOut

Name	Type	Description
`account_id`Required	string or null	An id that starts with `gla_`.
`amount`Required	string
`code`Required	string
`name`Required	string

CashFlowLineOut

Name	Type	Description
`account_id`Required	string	An id that starts with `gla_`.
`amount`Required	string
`code`Required	string
`name`Required	string

IncomeGroupOut

Name	Type	Description
`code`Required	string
`lines`Required	array of IncomeLineOut
`name`Required	string
`total`Required	string

TaxReportAccountOut

Name	Type	Description
`account_id`Required	string	An id that starts with `gla_`.
`amount`Required	string
`beginning`Required	string	Schedule L: the balance the day before the year began.
`code`Required	string
`name`Required	string
`source`Required	string

IncomeLineOut

Name	Type	Description
`account_id`Required	string	An id that starts with `gla_`.
`amount`Required	string
`code`Required	string
`name`Required	string