Energy Sharing Validation

Validate an Energy Sharing community application (§ 42c EnWG)

Executes a deterministic 6-step Energy Sharing validation pipeline: identity → generators → directMarketer → eligibility → decision → audit. Validates generator MaStR records, direct marketer status (§ 21 Abs. 2 EEG), share allocations, and § 42c EnWG eligibility criteria. Results are persisted to the validation database and retrievable via GET /validations/:id.

post/api/energy-sharing/validate

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/energy-sharing/validate
  • 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

gridOperatorIdstring

MaStR grid operator ID (SNB...)

gridOperatorBdewstring

13-digit BDEW market-partner code

communityNamestring

Name of the Energy Sharing community

communityIdstring

External community ID assigned by the VNB

generatorsobject[]

List of generator participants with mastrNummer, sharePercent, optional direktvermarkter

consumersobject[]

List of consumer participants with maloId, sharePercent, optional name

maxAgeMinutesinteger

Datapoint freshness threshold for Weg B (minutes)

datapointTagsstring[]

Tags for datapoint snapshot (Weg B fallback)

tokenstring

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

Example request

{
  "gridOperatorId": "SNB935578300972",
  "gridOperatorBdew": "9907473000008",
  "communityName": "Solargemeinschaft Rheinallee",
  "communityId": "ES-2026-001",
  "generators": [
    {
      "mastrNummer": "SEE904837264953",
      "sharePercent": 100,
      "direktvermarkter": "Next Kraftwerke GmbH"
    }
  ],
  "consumers": [
    {
      "maloId": "DE0001234567890123456789012345678",
      "sharePercent": 100,
      "name": "Whg. 1"
    }
  ],
  "datapointTags": [
    "stromdao-netze"
  ]
}

Response

EnergyShareValidationReport with findings from all 6 pipeline steps

Changes

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