# medianfi-com Forecast API

**Canonical:** https://apis.io/apis/medianfi-com/medianfi-com-forecast-api/  
**Provider:** medianfi-com — https://apis.io/providers/medianfi-com/  
**Base URL:** https://api.medianfi.com/api/v1  
**Documentation:** https://medianfi.com/docs

medianfi-com Forecast API is one of 58 APIs that [medianfi-com](https://apis.io/providers/medianfi-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Forecast. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Forecast API from medianfi-com — 25 operation(s) for forecast.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| GET | `/companies/{companyId}/forecast/projection` | Project the forecast model into all three scenarios (worst/base/best) |
| POST | `/companies/{companyId}/forecast/projection/preview` | Project a transient aggregate without persisting it |
| GET | `/companies/{companyId}/forecast/sensitivity` | Compute per-lever sensitivity (sorted by absolute 12-month cash delta) |
| GET | `/companies/{companyId}/forecast/decisions` | Get recommended decisions with tone and cash impact |
| GET | `/companies/{companyId}/forecast` | Get the persisted forecast aggregate for a company |
| POST | `/companies/{companyId}/forecast` | Create an empty persisted forecast model for a company |
| POST | `/companies/{companyId}/forecast/from-books` | Start an empty forecast from today's posted books cash |
| GET | `/companies/{companyId}/forecast/books-baseline` | Review a revenue baseline derived from posted books |
| POST | `/companies/{companyId}/forecast/{forecastId}/books-baseline/apply` | Apply the exact books revenue baseline the customer reviewed |
| GET | `/companies/{companyId}/forecast/active-sandbox` | Recover the one persisted AI or MCP sandbox from current books authority |
| POST | `/companies/{companyId}/forecast/steer` | Stage a typed AI forecast plan in an adhoc sandbox |
| PUT | `/companies/{companyId}/forecast/{modelId}` | Update forecast model header (label, businessType, startCashCents… |
| DELETE | `/companies/{companyId}/forecast/{modelId}` | Delete a persisted forecast model and its child rows |
| PATCH | `/companies/{companyId}/forecast/{forecastId}/financing-events/{eventId}/expected-date` | Set the first expected receipt date on an undated financing event |
| POST | `/companies/{companyId}/forecast/{forecastId}/financing-events/{eventId}/receipt` | Confirm a financing assumption corresponds to one posted receipt |
| POST | `/companies/{companyId}/forecast/{forecastId}/streams` | Add a revenue stream to the forecast |
| PUT | `/companies/{companyId}/forecast/{forecastId}/streams/{streamId}` | Update a forecast stream |
| DELETE | `/companies/{companyId}/forecast/{forecastId}/streams/{streamId}` | Delete a forecast stream |
| POST | `/companies/{companyId}/forecast/{forecastId}/headcount` | Add a headcount row to the forecast |
| PUT | `/companies/{companyId}/forecast/{forecastId}/headcount/{headcountId}` | Update a headcount row |
| DELETE | `/companies/{companyId}/forecast/{forecastId}/headcount/{headcountId}` | Delete a headcount row |
| POST | `/companies/{companyId}/forecast/{forecastId}/opex` | Add an operating expense row to the forecast |
| PUT | `/companies/{companyId}/forecast/{forecastId}/opex/{opexId}` | Update an opex row |
| DELETE | `/companies/{companyId}/forecast/{forecastId}/opex/{opexId}` | Delete an opex row |
| POST | `/companies/{companyId}/forecast/{forecastId}/scenarios` | Add a scenario to the forecast |
| DELETE | `/companies/{companyId}/forecast/{forecastId}/scenarios/{scenarioId}` | Delete a forecast scenario |
| PUT | `/companies/{companyId}/forecast/{forecastId}/scenarios/{scenarioId}` | Update a saved forecast scenario |
| POST | `/companies/{companyId}/forecast/{forecastId}/scenarios/{scenarioId}/merge` | Approve and merge a forecast sandbox into the live model |
| POST | `/companies/{companyId}/forecast/{forecastId}/scenarios/{scenarioId}/lock` | Lock a scenario as the single budget baseline for variance (#1159) |
| GET | `/companies/{companyId}/forecast/actuals` | Calendar-month actuals from the GL + calendar boundary (#1159, |
| GET | `/companies/{companyId}/forecast/variance` | Budget-vs-actual variance per completed calendar month (#1159) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/medianfi-com/openapi/medianfi-com-forecast-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/medianfi-com/json-schema/medianfi-com-practice-packet-v1-schema.json
- **JSONSchema** — https://artifacts.apis.io/medianfi-com/json-schema/medianfi-com-therapist-metrics-envelope-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/medianfi-com/json-schema/medianfi-com-sub-ledger-liabilities-view-schema.json
- **JSONSchema** — https://artifacts.apis.io/medianfi-com/json-schema/medianfi-com-quick-books-chart-push-preview-schema.json
- **JSONSchema** — https://artifacts.apis.io/medianfi-com/json-schema/medianfi-com-books-overview-schema.json
- **JSONSchema** — https://artifacts.apis.io/medianfi-com/json-schema/medianfi-com-agent-client-facts-schema.json

## Other medianfi-com APIs (12)

- [medianfi-com Accountant Assignments API](https://apis.io/apis/medianfi-com/medianfi-com-accountant-assignments-api/)
- [medianfi-com Accountant Documents API](https://apis.io/apis/medianfi-com/medianfi-com-accountant-documents-api/)
- [medianfi-com Accountant Portal API](https://apis.io/apis/medianfi-com/medianfi-com-accountant-portal-api/)
- [medianfi-com Accountants API](https://apis.io/apis/medianfi-com/medianfi-com-accountants-api/)
- [medianfi-com Accounting Classes API](https://apis.io/apis/medianfi-com/medianfi-com-accounting-classes-api/)
- [medianfi-com Accounting Tags API](https://apis.io/apis/medianfi-com/medianfi-com-accounting-tags-api/)
- [medianfi-com Admin API](https://apis.io/apis/medianfi-com/medianfi-com-admin-api/)
- [medianfi-com API Keys API](https://apis.io/apis/medianfi-com/medianfi-com-api-keys-api/)
- [medianfi-com AR/AP API](https://apis.io/apis/medianfi-com/medianfi-com-ar-ap-api/)
- [medianfi-com Attribution API](https://apis.io/apis/medianfi-com/medianfi-com-attribution-api/)
- [medianfi-com Auth API](https://apis.io/apis/medianfi-com/medianfi-com-auth-api/)
- [medianfi-com Bank Accounts API](https://apis.io/apis/medianfi-com/medianfi-com-bank-accounts-api/)

## Tags

Forecast

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/medianfi-com/medianfi-com-forecast-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/medianfi-com/.
