---
title: "Run Netzanschluss validation pipeline (6-step, deterministic)"
method: POST
path: "/api/grid-connection/validate"
tags: ["Grid Connection Validation"]
---

# Run Netzanschluss validation pipeline (6-step, deterministic)

`POST /api/grid-connection/validate`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/grid-connection/validate`
- Auth: none declared

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.

## Query parameters

- `token` string

## Request body

- object
  - `gridOperatorId` string: MaStR grid operator ID (SNB...)
  - `gridOperatorBdew` string: 13-digit BDEW market-partner code
  - `gridOperatorName` string: Grid operator name (fuzzy match via marketPartners)
  - `datapointTags` string[]: Tags for datapoint snapshot creation (Weg B)
  - `maxAgeMinutes` integer: Datapoint freshness threshold in minutes
  - `skipSteps` integer[]: Pipeline step numbers to skip (e.g. [4] skips EWK benchmark)
  - `includeCapacityCheck` boolean: Call cernion_connection_capacity_check for headroom data
  - `scenarioAdditions` object[]: Optional What-If installations added virtually for this validation run only.
    - `id` string
    - `type` string
    - `capacityKW` number
    - `capacityMW` number
    - `energietraeger` string
    - `voltageLevel` string
  - `scenarioCapacityMW` number: Optional extra capacity (MW) injected as a synthetic What-If installation.
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

ValidationReport with findings from all 6 pipeline steps

## Other responses

- `202`: REST/Gateway call accepted as async job. Poll /api/jobs/:jobId/status and /api/jobs/:jobId/result.

---

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