---
title: "Search German energy market partners by BDEW code, company name, or city"
method: GET
path: "/api/grid-operations/market-partners"
tags: ["Grid Operations"]
---

# Search German energy market partners by BDEW code, company name, or city

`GET /api/grid-operations/market-partners`

## Request

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

Search for German energy market participants including grid operators, suppliers, and balancing responsible parties.

**Search Types**:
- **BDEW Code**: 13-digit code (e.g., "9900992720003")
- **Company Name**: Full or partial name (e.g., "STROMDAO", "Stadtwerke Heidelberg")
- **City**: Location-based search (e.g., "Heidelberg", "München")

**Use Cases**:
- Resolve VNB names to BDEW codes for installations queries
- Find grid operator contact details
- Identify market partner roles (VNB, ÜNB, supplier, BKV)
- Data integration and mapping

**Response Fields**:
- BDEW code (13 digits)
- Company name and address
- Market partner roles
- Software systems in use
- Contact information
- MaStR IDs (SNB, GNB, etc.)

**Example Queries**:
- "STROMDAO Netze" → STROMDAO Netz GmbH with BDEW code
- "9900992720003" → Specific market partner details
- "Heidelberg" → All market partners in Heidelberg

## Query parameters

- `query` string, required: Search term: BDEW code, company name, or city
- `limit` number: Maximum number of results (1-20, default: 10)
- `format` 'json' | 'csv' | 'xlsx' | 'xls': Output format. "csv" and "xls"/"xlsx" trigger a file download.
- `token` string

## Response `200`

List of matching market partners

- object
  - `results` object[]
    - `bdew` string: BDEW code (13 digits)
    - `name` string: Company name
    - `address` string: Full address
    - `city` string
    - `postalCode` string
    - `roles` string[]: Market roles (VNB, ÜNB, supplier, etc.)
    - `mastrIds` object: MaStR operator IDs
  - `count` number: Number of results returned

---

[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)