default_alive
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.
What it shows
Default-alive check for one month: period-end cash, net burn and months of runway in that month’s functional currency unless a native ledger currency is explicit. Measured month-end MRR growth is bounded and applied to the recurring portion of recognized revenue; one-off revenue stays flat. Any input can be overridden for a what-if, and exclude_startup_credits shows burn gross of promotional credits.
Example MCP App view
The read-only example below uses illustrative demo data and the same report component as the MCP App. These are not your books or the result of the request example.
Inputs
Send the fixed kind and these parameters at the top level of the report request, not inside input.
Required means required within its containing object; an optional parent can be omitted.
| Field | Type | Required | Meaning and accepted values |
|---|---|---|---|
period | string | Yes | YYYY-MM. Format: month. Example: "2026-09". |
currency | string | No | Ledger currency (default: the functional currency active for the report period). Format: currency. |
cash_minor_units | string | No | What-if: cash in minor units (integer string) instead of the books'. |
monthly_revenue_minor_units | string | No | What-if: monthly revenue in minor units (integer string). |
monthly_expenses_minor_units | string | No | What-if: monthly expenses in minor units (integer string). |
monthly_growth_rate | number | No | What-if: month-over-month revenue growth as a decimal, e.g. 0.12 for 12%. Maximum: 5. |
exclude_startup_credits | boolean | No | true adds back promotional/startup credits applied this month (5950). |
Reading the result
Running this report does not change the books. Its description above distinguishes recorded-book summaries from previews based on supplied facts or assumptions. Interpret its totals, grouping, missing-data indicators and pagination using that description. Monetary amounts are integer strings in the reported unit; ratios and assumptions can be fractional numbers. An empty result is not evidence that the business had no activity.
The public OpenAPI contract does not enumerate this report’s result fields. Fetch GET /v1/reports for its live description and parameters, and inspect the returned JSON rather than assuming an output shape.
Example request
{
"kind": "default_alive",
"period": "2026-09"
}All reports · Operation and errors · Reusable schemas
Keep credentials out of prompts; rehearse writes only in a disposable sandbox.
Exact request schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"kind": {
"const": "default_alive"
},
"period": {
"description": "YYYY-MM.",
"type": "string",
"minLength": 1,
"pattern": "^[0-9]{4}-[0-9]{2}$"
},
"currency": {
"description": "Ledger currency (default: the functional currency active for the report period).",
"type": "string",
"minLength": 1
},
"cash_minor_units": {
"description": "What-if: cash in minor units (integer string) instead of the books'.",
"type": "string",
"minLength": 1
},
"monthly_revenue_minor_units": {
"description": "What-if: monthly revenue in minor units (integer string).",
"type": "string",
"minLength": 1
},
"monthly_expenses_minor_units": {
"description": "What-if: monthly expenses in minor units (integer string).",
"type": "string",
"minLength": 1
},
"monthly_growth_rate": {
"description": "What-if: month-over-month revenue growth as a decimal, e.g. 0.12 for 12%.",
"type": "number",
"exclusiveMinimum": -1,
"maximum": 5
},
"exclude_startup_credits": {
"description": "true adds back promotional/startup credits applied this month (5950).",
"type": "boolean"
}
},
"required": [
"kind",
"period"
]
}