---
title: "Detailed BMU database"
method: GET
path: "/gb/modo/detailed-bmu-list"
tags: ["Elexon"]
---

# Detailed BMU database

`GET /gb/modo/detailed-bmu-list`

## Request

- Base URL: `https://api.modoenergy.com/pub/v1`
- URL: `https://api.modoenergy.com/pub/v1/gb/modo/detailed-bmu-list`
- Auth: one of:
  - API key in header `X-Token`
  - none

This dataset contains a list of BMUs which includes locational details and thorough fuel type sorting.The valid_from field begins in April 2024, as that is when this dataset started to be compiled. All new BMUs are automatically added to this list.

## Query parameters

- `fuel_type` string
- `gsp_name` string
- `limit` integer
- `offset` integer

## Response `200`

Success

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` BMUGSP[], required
    - `gsp_group_id` string, required
    - `bmu_id` string, nullable
    - `bmu_name` string, nullable
    - `bmu_type` string, nullable
    - `ngc_bmu_id` string, nullable
    - `fuel_type` string, nullable
    - `lead_party_id` string, nullable
    - `lead_party_name` string, nullable
    - `trading_unit_name` string, nullable
    - `transmission_loss_factor` string, decimal, nullable
    - `valid_from` string, date, nullable
    - `valid_to` string, date, nullable
    - `gsp_name` string, nullable
    - `dno` string, nullable

## Other responses

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

---

[API](https://skmtc.dev/modoenergy/apis/modo-energy-api.md) - [All operations](https://skmtc.dev/modoenergy/apis/modo-energy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modoenergy/apis/modo-energy-api/revisions/7d9d1bd6ee06?raw)