---
title: "Review a revenue baseline derived from posted books"
method: GET
path: "/companies/{companyId}/forecast/books-baseline"
tags: ["Forecast"]
---

# Review a revenue baseline derived from posted books

`GET /companies/{companyId}/forecast/books-baseline`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/forecast/books-baseline`
- Auth: HTTP bearer

Returns a read-only proposal based on the latest one to three consecutive completed calendar months. The arithmetic average includes zero months and does not infer recurrence, growth, customers, or pricing. This endpoint performs no forecast mutation and fails closed without one legal entity and one reconciled functional-currency authority.

## Response `200`

Reviewable books baseline and optimistic review fingerprint

- object
  - `success` boolean
  - `data` ForecastBooksBaselineCandidate
    - `forecastId` string, uuid, required
    - `authority` 'posted_calendar_gl_v2', required
    - `calculation` 'trailing_completed_month_average', required
    - `legalEntityId` string, uuid, required
    - `functionalCurrency` string, required
    - `minorUnitExponent` 2, required
    - `moneyAuthorityVersion` 1, required
    - `periods` ForecastBooksBaselinePeriod[], required
      - `period` string, required
      - `revenueCents` integer, required
    - `totalRevenueCents` integer, required
    - `monthlyRevenueCents` integer, required
    - `fingerprint` string, required
    - `current` ForecastBooksBaselineCurrent, required
      - `streamId` string, uuid, required
      - `monthlyRevenueCents` integer, required
      - `fingerprint` string, nullable, required
    - `isCurrent` boolean, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `422`: Posted revenue is unavailable, non-positive, multi-entity, or currency-ambiguous

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)