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 Renewables API

Renewable and carbon-free percentage signals.

Electricity Maps Renewables 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 Renewables. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 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.

2 operations 2 paths 1 schemas 2 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 Renewables 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 2

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

Renewables 2

Renewable and carbon-free percentage signals.

GET
/v3/renewable-percentage/{temporality}
Get renewable percentage
getRenewablePercentage 2 params → 200
GET
/v3/carbon-free-percentage/{temporality}
Get carbon-free percentage
getCarbonFreePercentage 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-renewables-api-openapi.yml Raw ↑

Other APIs Electricity Maps publishes across the network.

Electricity Maps CarbonIntensity API
Electricity Maps ElectricityMix API
Electricity Maps GridMetrics API
Electricity Maps Pricing API
Electricity Maps Zones API