---
updatedAt: 2026-04-23T10:26:17.000Z
agentTools:
  projectIndex: https://developers.modoenergy.com/llms.txt
---

# Forecast Demand 2D

This dataset contains national electricity demand forecast for 2 days ahead as well as all historic 2 day ahead demand forecasts. The forecast assist the industry to make efficient decisions in balancing their supply and demand positions.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Modo Energy API",
    "description": "# Modo API documentation\n\n## Autorization\n\n1. For use this api you need get public api token at your [ModoEnergy](https://modo.energy/)  account\n1. Use your token at headers `X-Token: <token_from_account>`\n\n## Date format\n\nAPI can filter your data by date.\nDate format `YYYY-MM-DD`\nExample `2020-08-13`\n\n## Rate limitation\n\nPublic api has rate limit - 1000 requests per minute\n",
    "termsOfService": "https://www.google.com/policies/terms/",
    "contact": {
      "email": "contact@snippets.local"
    },
    "license": {
      "name": "BSD License"
    },
    "version": "v1"
  },
  "security": [
    {
      "api_key": []
    },
    {}
  ],
  "paths": {
    "/gb/national-grid/forecasts/demand-2d": {
      "get": {
        "operationId": "Forecast Demand 2D",
        "summary": "Forecast Demand 2D",
        "description": "This dataset contains national electricity demand forecast for 2 days ahead as well as all historic 2 day ahead demand forecasts. The forecast assist the industry to make efficient decisions in balancing their supply and demand positions.",
        "parameters": [
          {
            "name": "forecast_date_from",
            "in": "query",
            "description": "Start date at which the forecast was made. Ex: yyyy-mm-dd",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "forecast_date_to",
            "in": "query",
            "description": "End date at which the forecast was made. Ex: yyyy-mm-dd",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results to return per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10000
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The initial index from which to return the results.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "count",
                    "results"
                  ],
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "integer"
                    },
                    "next": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true
                    },
                    "previous": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TwoDayAheadDemandForecast"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "response": {
                      "type": "string"
                    }
                  },
                  "example": {
                    "response": "Bad Request"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "response": {
                      "type": "string"
                    }
                  },
                  "example": {
                    "response": "Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "response": {
                      "type": "string"
                    }
                  },
                  "example": {
                    "response": "Forbidden"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "response": {
                      "type": "string"
                    }
                  },
                  "example": {
                    "response": "Not Found"
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "response": {
                      "type": "string"
                    }
                  },
                  "example": {
                    "response": "Too Many Requests"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "NESO"
        ]
      },
      "parameters": []
    }
  },
  "servers": [
    {
      "url": "https://api.modoenergy.com/pub/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "X-Token",
        "in": "header"
      }
    },
    "schemas": {
      "TwoDayAheadDemandForecast": {
        "required": [
          "daysAhead",
          "targetDate",
          "forecastDemand",
          "cardinalPoint",
          "cpType",
          "cpStTime",
          "cpEndTime",
          "fPoint",
          "forecastDate"
        ],
        "type": "object",
        "properties": {
          "daysAhead": {
            "title": "DaysAhead",
            "type": "integer",
            "maximum": 2147483647,
            "minimum": -2147483648
          },
          "targetDate": {
            "title": "TargetDate",
            "type": "string",
            "format": "date"
          },
          "forecastDemand": {
            "title": "ForecastDemand",
            "type": "integer",
            "maximum": 2147483647,
            "minimum": -2147483648
          },
          "cardinalPoint": {
            "title": "CardinalPoint",
            "type": "string",
            "minLength": 1
          },
          "cpType": {
            "title": "CpType",
            "type": "string",
            "minLength": 1
          },
          "cpStTime": {
            "title": "CpStTime",
            "type": "string",
            "minLength": 1
          },
          "cpEndTime": {
            "title": "CpEndTime",
            "type": "string",
            "minLength": 1
          },
          "fPoint": {
            "title": "FPoint",
            "type": "string",
            "minLength": 1
          },
          "forecastDate": {
            "title": "ForecastDate",
            "type": "string",
            "format": "date"
          }
        }
      }
    }
  }
}
```