---
title: "Create Forecast Run (Deprecated)"
method: POST
path: "/forecasts/run-simulation/"
tags: ["Run Forecasts"]
deprecated: true
---

# Create Forecast Run (Deprecated)

`POST /forecasts/run-simulation/`

> **Deprecated.**

Create a revenue forecast using the Modo Energy forecasting model.

## Request body

- object
  - `id` string, uuid
  - `run_asset` object, required
    - `id` string, uuid
    - `asset_name` string, nullable, required
    - `address_line_1` string
    - `address_line_2` string, nullable
    - `city` string, nullable
    - `zip_code` string, required
    - `longitude` number, nullable
    - `latitude` number, nullable
    - `market_region` string
    - `start_date` string, date, required
    - `max_export` number, required
    - `custom_grid_curtailment_profile` object
      - `id` string, uuid
      - `file` string, uri
    - `custom_grid_curtailment_profile_id` string, uuid
    - `custom_uploaded_grid_curtailment_profile` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `custom_uploaded_grid_curtailment_profile_id` string, uuid
    - `custom_uploaded_wind_profile` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `custom_uploaded_wind_profile_id` string, uuid
    - `custom_power_prices` object
      - `id` string, uuid
      - `file` string, uri
      - `start_date` string, date, nullable — First date in the uploaded custom prices CSV
      - `end_date` string, date, nullable — Last date in the uploaded custom prices CSV
    - `custom_power_prices_id` string, uuid
    - `co_location` boolean, nullable, required
    - `rated_power` number, required
    - `duration` number, required
    - `charge_eff` number, required
    - `max_import` number, required
    - `degradation` boolean, nullable, required
    - `repowering` integer, nullable
    - `max_cycles` number, nullable, required
    - `battery_degradation` 'no_degradation' | 'standard_degradation_curve', required
    - `custom_degradation_curve_id` string, uuid
    - `custom_degradation_curve` object
      - `id` string, uuid
      - `file` string, uri
    - `custom_degradation_curve_file_name` string, nullable
    - `custom_uploaded_degradation_curve_id` string, uuid
    - `custom_uploaded_degradation_curve` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `custom_solar_profile_id` string, uuid
    - `custom_solar_profile` object
      - `id` string, uuid
      - `file` string, uri
    - `custom_uploaded_solar_profile_id` string, uuid
    - `custom_uploaded_solar_profile` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `solar_rated_power` number
    - `azimuth` number, nullable
    - `tilt` number, nullable
    - `solar_degradation` boolean, nullable
    - `solar_degradation_rate` number, nullable
    - `solar_export_mode` 'flexible' | 'force_export' | 'force_export_positive_prices', nullable
    - `coupling` boolean, nullable
    - `gb_run_asset` object, required
      - `gsp_group` 'East Midlands' | 'Eastern' | 'Merseyside & North Wales' | 'Midlands' | 'North Western' | 'North of Scotland' | 'Northern' | 'South Eastern' | 'South Wales' | 'South of Scotland' | 'Southern' | 'Yorkshire' | 'South Western' | 'London', nullable, required
      - `duos` boolean, nullable
      - `duos_details` object
        - `red_band_import_price` number, required
        - `red_band_export_price` number, required
        - `amber_band_import_price` number, required
        - `amber_band_export_price` number, required
        - `green_band_import_price` number, required
        - `green_band_export_price` number, required
        - `red_band_start_time` string, required
        - `red_band_end_time` string, required
        - `amber_band_morning_start_time` string, required
        - `amber_band_morning_end_time` string, required
        - `amber_band_evening_start_time` string, required
        - `amber_band_evening_end_time` string, required
        - `amber_band_weekend_start_time` string, required
        - `amber_band_weekend_end_time` string, required
        - `fixed_daily_charges` number, required
        - `daily_fixed_capacity_charges` number, required
      - `tnuos_generation_zone` 'North Scotland' | 'East Aberdeenshire' | 'Western Highlands' | 'Skye and Lochalsh' | 'Eastern Grampian and Tayside' | 'Central Grampian' | 'Argyll' | 'The Trossachs' | 'Stirlingshire and Fife' | 'South West Scotlands' | 'Lothian and Borders' | 'Solway and Cheviot' | 'North East England' | 'North Lancashire and The Lakes' | 'South Lancashire Yorkshire and Humber' | 'North Midlands and North Wales' | 'South Lincolnshire and North Norfolk' | 'Mid Wales and The Midlands' | 'Anglesey and Snowdon' | 'Pembrokeshire' | 'South Wales & Gloucester' | 'Cotswold' | 'Central London' | 'Essex and Kent' | 'Oxfordshire Surrey and Sussex' | 'Somerset and Wessex' | 'West Devon and Cornwall', nullable
      - `custom_solar_profile` object
        - `id` string, uuid
        - `file` string, uri
      - `cfd_strike_price` number
    - `connection_type` 'distribution' | 'transmission', nullable, required
  - `macro_scenario` string, uuid, required
  - `run_name` string, required
  - `company_name` string, nullable, required
  - `simulation_config` object, nullable — JSON payload for schema-driven dispatch. Validated against GDM schema before dispatch.
  - `status` 'draft' | 'processing' | 'ready_for_review' | 'failed' | 'qa'

## Response `201`

Created

- object
  - `id` string, uuid
  - `run_asset` object, required
    - `id` string, uuid
    - `asset_name` string, nullable, required
    - `address_line_1` string
    - `address_line_2` string, nullable
    - `city` string, nullable
    - `zip_code` string, required
    - `longitude` number, nullable
    - `latitude` number, nullable
    - `market_region` string
    - `start_date` string, date, required
    - `max_export` number, required
    - `custom_grid_curtailment_profile` object
      - `id` string, uuid
      - `file` string, uri
    - `custom_grid_curtailment_profile_id` string, uuid
    - `custom_uploaded_grid_curtailment_profile` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `custom_uploaded_grid_curtailment_profile_id` string, uuid
    - `custom_uploaded_wind_profile` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `custom_uploaded_wind_profile_id` string, uuid
    - `custom_power_prices` object
      - `id` string, uuid
      - `file` string, uri
      - `start_date` string, date, nullable — First date in the uploaded custom prices CSV
      - `end_date` string, date, nullable — Last date in the uploaded custom prices CSV
    - `custom_power_prices_id` string, uuid
    - `co_location` boolean, nullable, required
    - `rated_power` number, required
    - `duration` number, required
    - `charge_eff` number, required
    - `max_import` number, required
    - `degradation` boolean, nullable, required
    - `repowering` integer, nullable
    - `max_cycles` number, nullable, required
    - `battery_degradation` 'no_degradation' | 'standard_degradation_curve', required
    - `custom_degradation_curve_id` string, uuid
    - `custom_degradation_curve` object
      - `id` string, uuid
      - `file` string, uri
    - `custom_degradation_curve_file_name` string, nullable
    - `custom_uploaded_degradation_curve_id` string, uuid
    - `custom_uploaded_degradation_curve` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `custom_solar_profile_id` string, uuid
    - `custom_solar_profile` object
      - `id` string, uuid
      - `file` string, uri
    - `custom_uploaded_solar_profile_id` string, uuid
    - `custom_uploaded_solar_profile` object
      - `id` string, uuid
      - `file_type` 'degradation_curve' | 'grid_charges' | 'grid_curtailment' | 'solar_profile' | 'wind_profile', required
      - `file` string, uri
      - `filename` string
      - `uploaded_by` string, email
    - `solar_rated_power` number
    - `azimuth` number, nullable
    - `tilt` number, nullable
    - `solar_degradation` boolean, nullable
    - `solar_degradation_rate` number, nullable
    - `solar_export_mode` 'flexible' | 'force_export' | 'force_export_positive_prices', nullable
    - `coupling` boolean, nullable
    - `gb_run_asset` object, required
      - `gsp_group` 'East Midlands' | 'Eastern' | 'Merseyside & North Wales' | 'Midlands' | 'North Western' | 'North of Scotland' | 'Northern' | 'South Eastern' | 'South Wales' | 'South of Scotland' | 'Southern' | 'Yorkshire' | 'South Western' | 'London', nullable, required
      - `duos` boolean, nullable
      - `duos_details` object
        - `red_band_import_price` number, required
        - `red_band_export_price` number, required
        - `amber_band_import_price` number, required
        - `amber_band_export_price` number, required
        - `green_band_import_price` number, required
        - `green_band_export_price` number, required
        - `red_band_start_time` string, required
        - `red_band_end_time` string, required
        - `amber_band_morning_start_time` string, required
        - `amber_band_morning_end_time` string, required
        - `amber_band_evening_start_time` string, required
        - `amber_band_evening_end_time` string, required
        - `amber_band_weekend_start_time` string, required
        - `amber_band_weekend_end_time` string, required
        - `fixed_daily_charges` number, required
        - `daily_fixed_capacity_charges` number, required
      - `tnuos_generation_zone` 'North Scotland' | 'East Aberdeenshire' | 'Western Highlands' | 'Skye and Lochalsh' | 'Eastern Grampian and Tayside' | 'Central Grampian' | 'Argyll' | 'The Trossachs' | 'Stirlingshire and Fife' | 'South West Scotlands' | 'Lothian and Borders' | 'Solway and Cheviot' | 'North East England' | 'North Lancashire and The Lakes' | 'South Lancashire Yorkshire and Humber' | 'North Midlands and North Wales' | 'South Lincolnshire and North Norfolk' | 'Mid Wales and The Midlands' | 'Anglesey and Snowdon' | 'Pembrokeshire' | 'South Wales & Gloucester' | 'Cotswold' | 'Central London' | 'Essex and Kent' | 'Oxfordshire Surrey and Sussex' | 'Somerset and Wessex' | 'West Devon and Cornwall', nullable
      - `custom_solar_profile` object
        - `id` string, uuid
        - `file` string, uri
      - `cfd_strike_price` number
    - `connection_type` 'distribution' | 'transmission', nullable, required
  - `macro_scenario` string, uuid, required
  - `run_name` string, required
  - `company_name` string, nullable, required
  - `simulation_config` object, nullable — JSON payload for schema-driven dispatch. Validated against GDM schema before dispatch.
  - `status` 'draft' | 'processing' | 'ready_for_review' | 'failed' | 'qa'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/modoenergy/apis/modo-energy-api.md) · [All operations](https://skmtc.net/modoenergy/apis/modo-energy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modoenergy/modo-energy-api/versions/6c4b83d3fc12/schema)