Skip to content
StartupBuilderby Startups.Studio
Business
Changelog
Finance

Forecast

A Forecast is a dated week-by-week projection of a Startup’s cash, revenue and Cost, computed from its records, that sets its spend state.

Properties

PropertyTypeRequiredDescription
asOfdatetimerequiredWhen the inputs were read.
runwayWeeksnumberrequiredWeeks until cash reaches zero at the projected rates.
defaultAlivebooleanrequiredTrue when projected revenue covers projected Cost before cash runs out.
profitWeekdateThe first week projected revenue covers fully loaded Cost.
spendStatestringrequiredThe spend state it sets: free when default alive, tight when default dead, hold under 13 weeks of runway.

Object

JSON
{
  "$id": "https://api.sb/patentpad.com/forecasts/forecast_1",
  "$type": "Forecast",
  "asOf": "2026-10-22T12:00:00Z",
  "runwayWeeks": 1,
  "defaultAlive": true,
  "profitWeek": "2026-10-22",
  "spendState": "free"
}

Relationships

  • A Forecast has one Startup: the default-alive check writes a Forecast every week and after every large money Decision; the latest sets the spend state. startup, inverse forecasts.

Verbs

  1. createCreates a Forecast.
    POST /{namespace}/forecastsdoForecast.created
  2. getReturns one Forecast by id.
    GET /{namespace}/forecasts/{id}readNo Event
  3. listReturns Forecasts, newest first, one page at a time.
    GET /{namespace}/forecastsreadNo Event

A Forecast is kept forever and never edited: it has no update or delete.

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Forecast.createYesYesYesNo
Forecast.getYesYesYesYes
Forecast.listYesYesYesYes

Call it

Text
Add a forecast to ShiftNote.

Example

A Startup with $180,000 in cash and $9,000 of weekly net burn gets a Forecast of 20 runway weeks. Revenue does not cover Cost in that window, so defaultAlive is false and the spend state is tight.

Entitlement.update

Previous Page

Forecast.create

Next Page