Grid Connection Validation

Run Netzanschluss validation pipeline (6-step, deterministic)

Executes a deterministic 6-step grid connection validation pipeline: inventory → delta → capacity → EWK benchmark → Go/No-Go decision → audit trail. No LLM involvement — identical inputs always produce identical finding codes. Results are persisted to the validation database and retrievable via GET /validations/:id.

post/api/grid-connection/validate

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/grid-connection/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

gridOperatorNamestring

Grid operator name (fuzzy match via marketPartners)

datapointTagsstring[]

Tags for datapoint snapshot creation (Weg B)

maxAgeMinutesinteger

Datapoint freshness threshold in minutes

skipStepsinteger[]

Pipeline step numbers to skip (e.g. [4] skips EWK benchmark)

includeCapacityCheckboolean

Call cernion_connection_capacity_check for headroom data

scenarioCapacityMWnumber

Optional extra capacity (MW) injected as a synthetic What-If installation.

tokenstring

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

Example request

{
  "gridOperatorId": "SNB935578300972",
  "gridOperatorBdew": "9907473000008",
  "gridOperatorName": "STROMDAO Netze",
  "datapointTags": [
    "stromdao-netze"
  ],
  "skipSteps": [],
  "scenarioAdditions": [
    {
      "id": "whatif-pv-1",
      "type": "solar",
      "capacityMW": 1.5,
      "voltageLevel": "MS"
    }
  ],
  "scenarioCapacityMW": 2.5
}

Response

ValidationReport with findings from all 6 pipeline steps

Changes

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