---
title: "Contractual instruments in force during a calendar year"
method: GET
path: "/net-zero/electricity-instruments"
---

# Contractual instruments in force during a calendar year

`GET /net-zero/electricity-instruments`

By instrument type, with certified kWh pro-rated by the days of each period inside the year. Requires org.view_dashboard.

## Query parameters

- `year` integer, required

## Response `200`

The year's instruments

- NetZeroElectricityInstrumentsResponse
  - `data` object, required
    - `activeSites` integer, required
    - `groups` object[], required
      - `certifiedKwh` number, double, nullable, required
      - `instruments` integer, required
      - `type` 'ppa' | 'green_tariff' | 'unbundled_eac' | 'default_grid', required
    - `sitesWithLowCarbon` integer, required — Sites with a PPA, green tariff or certificates in force at some point in the year.
    - `year` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-10-02** `766c2a40e369` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/net-zero/electricity-instruments/get.md)

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greentally/apis/esgai-api/revisions/766c2a40e369?raw)