# Report reference Reports return read-only views and calculations. Some summarize the recorded books; others preview supplied facts or model assumptions. Each page explains the question a report answers, its parameters and date rules, and how to interpret its result. Descriptions, parameter meanings and examples come from the public report catalog; exact request schemas come from OpenAPI. Run a report through `POST /v1/reports`, or use the [CLI](/docs/cli/) with `reports run`. Choose the business, unit and date window explicitly when comparing results. Follow the report's pagination; one page need not contain the entire result. Fetch `GET /v1/reports` for the live descriptions and allowed parameters. The public reference grants no access; the authenticated business catalog is authority. OpenAPI does not enumerate report result fields, so inspect returned JSON and use the meaning documented for the particular report. Agents can read each report's `index.md` mirror. See the [HTTP reference](/docs/api-reference/) for transport and errors and the [command reference](/docs/command-reference/) for changes that feed the reports. ## Targeted reference pages for agents Fetch only the operation or variant you need. These Markdown pages preserve its exact OpenAPI schemas and link back to shared parameters and errors. The full export is at https://economi.co/docs/api-reference/full/index.md. - [payroll_provider](https://economi.co/docs/report-reference/payroll-provider/index.md): Paged funding, amounts owed and settlements of a party with a recorded payroll-provider relationship. - [people_costs](https://economi.co/docs/report-reference/people-costs/index.md): Read each person's employment cost over the selected work-month window, with components and explicit missing attribution or work periods. - [concessions](https://economi.co/docs/report-reference/concessions/index.md): Read what each concession offer cost and earned over whole months: its discount, the gross revenue of the contracts that took it, and the totals by purpose. - [usage_estimates](https://economi.co/docs/report-reference/usage-estimates/index.md): Current usage totals per contract right and usage period: quantity, tier position, gross estimate, credit drawn, accrued, billed, difference and late usage. - [usage_cost](https://economi.co/docs/report-reference/usage-cost/index.md): Attributed vendor cost over usage periods starting in [from, until): gross recorded expense, promotional credits and net cost, with function, right and native currency. group_by selects customer, holder, team or project; attribution_value optionally selects one. - [vendor_utilization](https://economi.co/docs/report-reference/vendor-utilization/index.md): Per vendor contract: recognized cost, last use, paid seats against active holders, exact cost per holder, and paged meter periods with measured quantity against included allowance and exact unit cost. - [contract_deadlines](https://economi.co/docs/report-reference/contract-deadlines/index.md): Active contracts with a lifecycle deadline due through the requested day, ordered by their indexed next date. - [fx_rate](https://economi.co/docs/report-reference/fx-rate/index.md): Read a sourced exchange rate for a date, or the latest observation. This is a reference rate, not evidence of a payment's executed rate. - [activity_balances](https://economi.co/docs/report-reference/activity-balances/index.md): Read actual postings attributed to contract activities and parties, keeping each ledger's native unit separate. Does not post scheduled activity. - [party_contract_values](https://economi.co/docs/report-reference/party-contract-values/index.md): Compare agreed contract value, billed amounts, payments and balances by counterparty and native unit. Unknown prices remain unknown; this is not recognized revenue. - [activity_claims](https://economi.co/docs/report-reference/activity-claims/index.md): Read priced-right receivables, payables and funding claims, with their evidence, component identities and outstanding amounts. Use this to check what remains owed before allocating a payment. - [contract_books](https://economi.co/docs/report-reference/contract-books/index.md): Read what one priced-rights contract comes to on the books: who paid each claim and through which account, what reached the income statement, units and capital issued, and the latest period each right billed. - [activity_plan](https://economi.co/docs/report-reference/activity-plan/index.md): Preview scheduled but unrecorded contract activity. Missing usage or evidence remains conditional; nothing is recorded or settled. - [pipeline](https://economi.co/docs/report-reference/pipeline/index.md): Read opportunity estimates by customer, vendor or financing and by currency. Acceptance evidence determines wins; unknown values remain unknown. - [activity_capacity](https://economi.co/docs/report-reference/activity-capacity/index.md): Read available, reserved, consumed and expired native-unit capacity at a cutoff. Does not expire lots or change balances. - [activity_effects](https://economi.co/docs/report-reference/activity-effects/index.md): Inspect or preview a legacy activity's effects without recording it. Priced-right previews are unsupported. - [owner_balance](https://economi.co/docs/report-reference/owner-balance/index.md): Read one person's outstanding owner balance and cash reimbursements, separately by currency. - [balances](https://economi.co/docs/report-reference/balances/index.md): Read account debits, credits and balances in one GAAP ledger's native currency. - [mapped_trial_balance](https://economi.co/docs/report-reference/mapped-trial-balance/index.md): Map a native trial balance through the business's evidenced reporting profile. Unmapped or conflicting balances remain explicit. - [balance_sheet](https://economi.co/docs/report-reference/balance-sheet/index.md): Read assets, liabilities and equity as of a date. Without one, includes all recorded postings, including future-dated ones. Amounts remain in the selected ledger currency. - [capital_accounts](https://economi.co/docs/report-reference/capital-accounts/index.md): Read capital by owner as of a date, including contributions, allocations and draws. Does not imply that an accounting balance is cash available to distribute. - [income_statement](https://economi.co/docs/report-reference/income-statement/index.md): Read revenue, expenses and net income for a date window. Omitting both bounds includes all postings; select currency for a native-ledger view across currency changes. - [income_statement_periods](https://economi.co/docs/report-reference/income-statement-periods/index.md): Read monthly revenue, expenses and net income over a trailing window. The current month is identified because it is incomplete. - [revenue_summary](https://economi.co/docs/report-reference/revenue-summary/index.md): Read customer invoicing, matched collections, outstanding claims and recognized revenue, separately by currency. - [recognition](https://economi.co/docs/report-reference/recognition/index.md): Read actual deferred revenue, releases and refunds. Legacy planned releases are conditional forecasts; priced-right forecasts are unsupported. - [amortization](https://economi.co/docs/report-reference/amortization/index.md): Read actual prepaid expenses and releases. Legacy planned releases are conditional forecasts; priced-right forecasts are unsupported. - [aging](https://economi.co/docs/report-reference/aging/index.md): Read outstanding receivables or payables as of a date, grouped by evidenced due date and currency. Missing due dates remain unknown. - [saas_metrics](https://economi.co/docs/report-reference/saas-metrics/index.md): Read recurring revenue, retention, margin, burn and runway metrics for a month, quarter or year. Month-only metrics use recorded month-end contract history. - [default_alive](https://economi.co/docs/report-reference/default-alive/index.md): Estimate whether the business reaches profitability before cash runs out, using monthly burn and bounded recurring growth. Overrides are what-if assumptions, not recorded facts. - [unit_economics](https://economi.co/docs/report-reference/unit-economics/index.md): Read revenue per recorded customer activity unit and its attributed costs. Costs without customer attribution are shown separately, not allocated. - [platform_fees](https://economi.co/docs/report-reference/platform-fees/index.md): Preview Economico plan and revenue fees for a month. Currency conversions are indicative; this preview does not accrue or charge a fee. - [model_preview](https://economi.co/docs/report-reference/model-preview/index.md): Preview a proposed product catalog, customer and vendor model without recording it. Unknown prices, variable costs and tax assumptions remain explicit. - [cap_table](https://economi.co/docs/report-reference/cap-table/index.md): Read issued instruments, vesting and recognized convertible commitments. Dilution combines issued classes one-for-one; options and unconverted financing are excluded from the diluted share total.