---
title: "Get activity projections"
method: GET
path: "/v1/baseline_forecasts/activity_projections"
tags: ["Baseline forecasts"]
---

# Get activity projections

`GET /v1/baseline_forecasts/activity_projections`

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

## Query parameters

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

## Response `200`

Activity projections retrieved successfully

- object
  - `projections` ActivityDataProjection[]
    - `config` ActivityDataProjectionConfig, required
      - `id` string, uuid, required
      - `scenarioID` string, uuid, required
      - `processID` string, uuid, required
      - `emissionsSourceID` string, uuid, required
      - `emissionsSourceTypeID` string, uuid, required
      - `emissionsModelID` string, uuid, required
      - `activityTypeID` string, uuid, required
      - `activityType` string, required
      - `scope` 1 | 2 | 21 | 22 | 3 | -1, required — The GHG protocol scope this source belongs to
      - `startYear` string, required
      - `endYear` string, required
      - `valueProjectionMethod` 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
      - `emissionsProjectionMethod` 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
      - `emissionsFactorsOverrides` EmissionsFactorOverride[], required
        - `key` string, required
        - `value` number, required
        - `unit` string, required — A unit of measurement (e.g., kg, MWh, etc).
      - `secondaryActivityValueOverrides` SecondaryActivityValueOverride[], required
        - `displayName` string, required
        - `key` string, required
        - `value` number, required
        - `unit` string, required — A unit of measurement (e.g., kg, MWh, etc).
    - `projection` ActivityDataProjectionData, required
      - `id` string, uuid, required
      - `processID` string, uuid, required
      - `emissionsSourceID` string, uuid, required
      - `emissionsSourceTypeID` string, uuid, required
      - `emissionsModelID` string, uuid, required
      - `activityTypeID` string, uuid, required
      - `activityType` string, required
      - `scope` 1 | 2 | 21 | 22 | 3 | -1, required — The GHG protocol scope this source belongs to
      - `startYear` string, required
      - `endYear` string, required
      - `serverUnit` string, required — A unit of measurement (e.g., kg, MWh, etc).
      - `displayUnit` string, required — A unit of measurement (e.g., kg, MWh, etc).
      - `emissionsUnit` string, required — A unit of measurement (e.g., kg, MWh, etc).
      - `secondaryActivityValues` YearData[], required
        - `year` string, required
        - `value` number, required
      - `historicalActivityValues` YearData[], required
        - `year` string, required
        - `value` number, required
      - `projectedActivityValues` YearData[], required
        - `year` string, required
        - `value` number, required
      - `historicalScopeEmissions` YearData[], required
        - `year` string, required
        - `value` number, required
      - `projectedScopeEmissions` YearData[], required
        - `year` string, required
        - `value` number, required
      - `historicalBioCO2Emissions` YearData[], required
        - `year` string, required
        - `value` number, required
      - `projectedBioCO2Emissions` 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/versions/495dab1b31fd/schema)