---
title: "Bulk, paginated directory of German energy market actors (VNB/LIEFERANT/MSB)"
method: GET
path: "/api/grid-operations/market-actor-directory"
tags: ["Grid Operations"]
---

# Bulk, paginated directory of German energy market actors (VNB/LIEFERANT/MSB)

`GET /api/grid-operations/market-actor-directory`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/grid-operations/market-actor-directory`
- Auth: none declared

Enumerates German energy market actors (grid operators, suppliers, metering point operators) with real offset-based pagination — a bulk discovery seed, distinct from marketPartners/vnbLookup which are built for single/few-result identity resolution.

**Use case:** organisation discovery seed list (e.g. iterating public websites for customer-service/FAQ pages) without needing the full MaStR export (~3GB) or scraping the MaStR web UI.

**Response fields per entry:** `entityId`, `companyName`, `bdewCodes[]`, `marketRoles[]`, `address.{city,postalCode,state}`, `website`, `mastrId`, `lastUpdated`.

**Known data gaps (source data, not this endpoint):** `address.state` is null for almost all entries; `mastrId` is only meaningful for VNB and depends on environment data.

## Query parameters

- `marketRoles` string[]
- `state` string
- `limit` integer
- `offset` integer
- `token` string

## Response `200`

Paginated market actor list

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)