---
title: "Monthly Leaderboard"
method: GET
path: "/gb/modo/benchmarking/monthly-leaderboard"
tags: ["Assets"]
---

# Monthly Leaderboard

`GET /gb/modo/benchmarking/monthly-leaderboard`

GB Leaderboard results per calendar month

## Query parameters

- `date_from` string, required
- `date_to` string, required
- `asset_name` string
- `group_by` string
- `is_bmu` 'Yes' | 'No'
- `overall_units` 'GBP per hour per mw' | 'GBP per month per mw' | 'GBP per year per mw' | 'GBP per hour per mwh' | 'GBP per month per mwh' | 'GBP per year per mwh'
- `is_long_term` 'Yes' | 'No'
- `limit` integer
- `offset` integer

## Response `200`

Success

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` MonthyLeaderboardBreakdown[], required
    - `date` string
    - `asset` string, nullable
    - `owner` string, nullable
    - `operator` string, nullable
    - `is_bmu` boolean, required
    - `is_long_term` boolean, required
    - `wholesale` number
    - `dcl` number
    - `dml` number
    - `dmh` number
    - `drl` number
    - `drh` number
    - `bm` number
    - `efr` number
    - `wffr` number
    - `mffr` number
    - `dch` number
    - `cm` number
    - `triads` number
    - `imbalance` number
    - `soc` number
    - `br` number
    - `rank` integer, required
    - `previous_rank` integer
    - `rated_power_mw` number, required
    - `energy_capacity_mwh` number, required
    - `bmu` boolean, required
    - `contracted_power` number, required
    - `cycles_per_day` number, required
    - `change_on_last_month` number
    - `monthly_revenue` number, required
    - `merchant` number, required
    - `current_month` number, required
    - `previous_month` number
    - `ytd` number
    - `overall_units` string
    - `qr` string, decimal
    - `sr` string, decimal

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/modoenergy/apis/modo-energy-api.md) · [All operations](https://skmtc.net/modoenergy/apis/modo-energy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modoenergy/modo-energy-api/versions/6c4b83d3fc12/schema)