Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Electricity Maps GridMetrics API

Total load, net load, and electricity flows between zones.

Electricity Maps GridMetrics API is one of 6 APIs that Electricity Maps publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include GridMetrics. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 3 operations across 3 paths, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 3.0.

Requests are made against a single base URL, https://api.electricitymap.org.

3 operations 3 paths 1 schemas 3 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3.0
Base URL
https://api.electricitymap.org
Authentication
API Key, HTTP Basic
License
Resource Areas
1

Authentication & Security 2

Electricity Maps GridMetrics API declares 2 security schemes for authenticating requests. An API key is passed in the header as auth-token (authToken). It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • authToken — API token issued from the Electricity Maps portal.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.

GridMetrics 3

Total load, net load, and electricity flows between zones.

GET
/v3/total-load/{temporality}
Get total load
getTotalLoad 2 params → 200
GET
/v3/net-load/{temporality}
Get net load
getNetLoad 2 params → 200
GET
/v3/electricity-flows/{temporality}
Get electricity flows
getElectricityFlows 2 params → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is SignalResponse (9 properties). Each schema is shown below with its type and property counts.

SignalResponse
object
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

electricity-maps-gridmetrics-api-openapi.yml Raw ↑

Other APIs Electricity Maps publishes across the network.

Electricity Maps CarbonIntensity API
Electricity Maps ElectricityMix API
Electricity Maps Pricing API
Electricity Maps Renewables API
Electricity Maps Zones API