---
title: "List installations of a Direktvermarkter (direct energy marketer)"
method: POST
path: "/api/assets/by-direktvermarkter"
tags: ["Assets"]
---

# List installations of a Direktvermarkter (direct energy marketer)

`POST /api/assets/by-direktvermarkter`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/assets/by-direktvermarkter`
- Auth: none declared

Retrieves MaStR installations assigned to a given direct energy marketer (Direktvermarkter) using the direktvermarkterName or direktvermarkterMastrId filter. Step 2 of the Direktvermarkter pipeline. Supports filtering by type, commissioning year, capacity, and Bundesland.

⚠️ **Data Availability Limitation**: The `DirektvermarkterMastrNummer` field is deliberately excluded from all public MaStR bulk exports (BNetzA policy — commercially sensitive data). As a result, the `direktvermarkterName` and `direktvermarkterMastrId` filter parameters are not populated in the local MongoDB and **will return 0 results** in practice. The best available public proxy for installations in Direktvermarktung is `fernsteuerbarkeitDv: true` combined with `minCapacity: 100` — available for Wind and Biomass only (field not present in Solar/Storage).

## Query parameters

- `token` string

## Request body

- object
  - `direktvermarkterName` string: Direktvermarkter company name (fuzzy match)
  - `direktvermarkterMastrId` string: Exact MaStR ID of the Direktvermarkter
  - `installationType` 'solar' | 'wind' | 'storage' | 'biomass' | 'hydro' | 'combustion' | 'all': Filter by installation type (default: all)
  - `minCapacityKW` number: Minimum installed capacity in kW
  - `maxCapacityKW` number: Maximum installed capacity in kW
  - `bundesland` string: Filter by federal state
  - `limit` integer: Maximum number of results (default: 1000)
  - `offset` integer: Pagination offset
  - `format` 'json' | 'csv' | 'xlsx': Output format
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Successful response

- object

---

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