Get trailing actuals

GET /api/v1/cfo-projection/actuals

Trailing income statement actuals shaped for the projection page. Pass start_month/end_month (YYYY-MM) to pin an explicit window; otherwise the last trailing_months closed months are returned.

Operation ID: get_actuals_api_v1_cfo_projection_actuals_get · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Query

trailing_months integer default: 6

Number of trailing months (used when start/end unset)

start_month string

Inclusive window start in YYYY-MM. Required together with end_month.

end_month string

Inclusive window end in YYYY-MM. Required together with start_month.

hide_zero_rows boolean default: False

Exclude line items with all-zero values

Responses

200 Successful Response

Schema: ProjectionActualsResponse

months array · string required

Month labels in display order, e.g. ['Oct 2025', ...]

revenue array · ActualsLineItem requiredActualsLineItem
3 fields
ledger_id string required
name string required
data array · integer required

Per-month amounts in cents, oldest first

cogs array · ActualsCostLineItem requiredActualsCostLineItem
6 fields
ledger_id string required
name string required
data array · integer required

Per-month amounts in cents, oldest first

type CostClassification CostClassification
esc number

Estimated annual escalation for fixed costs

growth number

Estimated MoM growth rate

opex array · ActualsCostLineItem requiredActualsCostLineItem
6 fields
ledger_id string required
name string required
data array · integer required

Per-month amounts in cents, oldest first

type CostClassification CostClassification
esc number

Estimated annual escalation for fixed costs

growth number

Estimated MoM growth rate

other array · ActualsOtherLineItem requiredActualsOtherLineItem
4 fields
ledger_id string required
name string required
data array · integer required

Per-month amounts in cents, oldest first

neg boolean

True if this is an expense (negative)

400 Bad Request - Invalid input

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

404 Not Found - Resource does not exist

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError
5 fields
loc array · string | integer required
msg string required
type string required
input object
ctx object