---
title: "Get main metric projections"
method: GET
path: "/v1/baseline_forecasts/main_metric_projections"
tags: ["Baseline forecasts"]
---

# Get main metric projections

`GET /v1/baseline_forecasts/main_metric_projections`

Retrieves a list of main metric projections filtered by baseline scenario ID and optionally by business entity ID. If no business entity ID is provided, the main metric projections for the entire organization will be returned. This endpoint supports pagination, since the number of main metric projections can be quite large.

## Query parameters

- `baseline_scenario_id` string, uuid, required
- `business_entity_id` string, uuid
- `offset` integer
- `limit` integer

## Response `200`

Main metric projections retrieved successfully

- object
  - `projections` MainMetricProjection[]
    - `config` MainMetricProjectionConfig, required
      - `id` string, uuid, required
      - `processID` string, uuid, required
      - `baselineScenarioID` string, uuid, required
      - `startYear` string, required
      - `endYear` string, required
      - `projectionMethod` union, required — Describes how a projection is configured. This is a discriminated union of objects with a 'projectionMethod' property of type ProjectionMethod.
        - object
          - `projectionMethod` 'HISTORICAL_AVERAGE_GROWTH_RATE', required
          - `baseYear` string, required
          - `historicalPeriodStart` string, required
          - `historicalPeriodEnd` string, required
        - object
          - `projectionMethod` 'HISTORICAL_AVERAGE_VALUE', required
          - `historicalPeriodStart` string, required
          - `historicalPeriodEnd` string, required
        - object
          - `projectionMethod` 'HISTORICAL_FIXED_VALUE', required
          - `baseYear` string, required
        - object
          - `projectionMethod` 'CUSTOM_DATA', required
          - `yearlyValues` YearData[], required
            - `year` string, required
            - `value` number, required
        - object
          - `projectionMethod` 'CUSTOM_GROWTH_RATE', required
          - `baseYear` string, required
          - `customGrowthRate` number, required
        - object
          - `projectionMethod` 'CUSTOM_YEARLY_PERCENTAGE_CHANGES', required
          - `baseYear` string, required
          - `yearlyValues` YearData[], required
            - `year` string, required
            - `value` number, required
    - `projection` MainMetricProjectionData, required
      - `id` string, uuid, required
      - `processID` string, uuid, required
      - `startYear` string, required
      - `endYear` string, required
      - `valuesBaseYear` string, required
      - `functionalUnit` FunctionalUnit
        - `id` string, uuid, required
        - `name` string, required — The name of the functional unit
        - `description` string — The description of the functional unit
        - `defaultDisplayUnit` string, required — A unit of measurement (e.g., kg, MWh, etc).
        - `supportedUnits` Unit[], required
        - `orgID` string, uuid, nullable
        - `subIndustryCode` string, nullable, required — The sub-industry code of the business entity or functional unit, formatted as eight digits.
        - `measurementType` 'COUNTER' | 'GAUGE' — The type of measurement of the functional unit. COUNTER is used for attributes that are added across time periods (e.g., steel produced). GAUGE is used for attributes that are not added across time periods (e.g., number of employees).
      - `displayUnit` string, required — A unit of measurement (e.g., kg, MWh, etc).
      - `historicalValues` YearData[], required
        - `year` string, required
        - `value` number, required
      - `projectedValues` YearData[], required
        - `year` string, required
        - `value` number, required
  - `pagination` PaginationResult
    - `offset` integer, required — The current offset in the pagination
    - `limit` integer, required — The maximum number of items per page
    - `total` integer, required — The total number of items available
    - `hasMore` boolean, required — Whether there are more items available after this page
    - `nextOffset` integer, nullable — The offset for the next page, if available
    - `previousOffset` integer, nullable — The offset for the previous page, if available

## Other responses

- `403` — You are not authorized to acess this object

---

[API](https://skmtc.net/sinai/apis/sinai-api.md) · [All operations](https://skmtc.net/sinai/apis/sinai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinai/sinai-api/revisions/495dab1b31fd/schema)