API Reference

The GridMind REST API

A fully RESTful API with JSON responses, OpenAPI 3.1 spec, and official SDKs for Python, Node.js, Go, and Java.

v2.4.1Base URL: api.gridmindai.co/v2OpenAPI 3.1
FORECASTING

POST /forecast

Generate GPU-accelerated demand forecasts for one or multiple grid nodes. Supports 15-min to 7-day horizons.

OPTIMIZATION

POST /optimize

Trigger the RL optimization engine for real-time load dispatch across your node network. Returns commands in <50ms.

TELEMETRY

POST /telemetry/ingest

Stream real-time sensor readings from your grid nodes. Supports batch ingest up to 50,000 events/sec.

COMPLIANCE

GET /reports/csrd

Generate automated CSRD Article 8 and GRI 302/305 compliance reports for any time period.

NODES

GET /nodes

List and manage your registered grid nodes, current status, load readings, and model assignment.

WEBHOOKS

POST /webhooks

Register webhook endpoints to receive real-time alerts for anomalies, forecast updates, and optimization events.

Example Request

POST /v2/forecast

Requestapplication/json
{{
  "grid_id": "grid-eu-west-01",
  "horizon": "72h",
  "resolution": "15min",
  "model": "temporal-transformer-v4",
  "features": ["weather", "market", "ev_load"],
  "confidence_intervals": [0.8, 0.95]
}}
Response 20047ms latency
{{
  "forecast_id": "fcst_01h9x4r7...",
  "model_version": "temporal-transformer-v4.2.1",
  "accuracy_expected": 0.987,
  "predictions": [
    {{
      "timestamp": "2025-05-13T14:15:00Z",
      "demand_mw": 3847.2,
      "ci_80": [3710.1, 3984.3],
      "renewable_mw": 1203.4
    }}
    // ... 287 more intervals
  ]
}}