Grid Operations

Lookup Direktvermarkter (direct energy marketer) in MaStR

Identifies a direct energy marketer (Direktvermarkter) in the MaStR registry and returns portfolio metadata.

Use Cases:

  • Identify the MaStR ID of a direct marketer for downstream portfolio queries
  • Get portfolio size (number of installations) and total installed capacity
  • First step of the Direktvermarkter pipeline before fetching all installations

Direktvermarkter Pipeline:

  1. grid-operations.direktvermarkterLookup (this step) → resolves name/ID → MaStR ID + portfolio stats
  2. assets.byDirektvermarkter → fetches all installations in the Direktvermarkter's portfolio

Known Direktvermarkter examples: NextKraftwerke, Statkraft, BayWa r.e., EnBW Trading, Encavis

⚠️ Data Availability Limitation: DirektvermarkterMastrNummer is deliberately excluded from all public MaStR bulk exports (BNetzA policy — commercially sensitive data). The portfolio stats returned by cernion_direktvermarkter_lookup are derived from MarktakteureUndRollen.xml (actor-level data) and may be incomplete or stale. Cross-referencing to individual installation units by DV company is not possible through any public source. The assets.byDirektvermarkter step will return 0 results in practice because the direktvermarkterMastrNummer field is not populated in the local MongoDB. Use fernsteuerbarkeitDv: true + minCapacity: 100 via energy-market.installations as the best available public proxy (Wind/Biomass only).

post/api/grid-operations/direktvermarkter-lookup

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/grid-operations/direktvermarkter-lookup
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

namestring

Direktvermarkter company name (fuzzy match)

mastrIdstring

Exact MaStR ID of the Direktvermarkter (ABR… format)

onlyActiveboolean

Restrict portfolio stats to active direct marketing contracts

limitinteger

Maximum number of matches returned (default: 10, max: 100)

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "name": "Next Kraftwerke",
  "mastrId": "ABR123456789"
}

Response

Successful response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.