Deterministic 6-step Netzanschluss validation pipeline (v0.14). Produces structured findings and a Go/No-Go decision sealed with a PouchDB snapshot for audit integrity. No LLM involvement — identical inputs always produce identical finding codes.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-grid-connection-validation-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cernion Energy Tools Grid Connection Validation API
version: 0.99.22
description: 'MicroService Agent System for Energy Markets - REST API with AI integration.
CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.
For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
description: API Server
tags:
- name: Grid Connection Validation
description: Deterministic 6-step Netzanschluss validation pipeline (v0.14). Produces structured findings and a Go/No-Go decision sealed with a PouchDB snapshot for audit integrity. No LLM involvement — identical inputs always produce identical finding codes.
paths:
/api/grid-connection/validate:
post:
summary: Run Netzanschluss validation pipeline (6-step, deterministic)
tags:
- Grid Connection Validation
operationId: grid_connection_validate
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: ValidationReport with findings from all 6 pipeline steps
content:
application/json:
example:
success: true
id: a1b2c3d4-...
decision: GO_CONDITIONAL
summary:
totalInstallations: 59
totalCapacityMW: 73.4
findingsCount:
info: 4
warning: 7
error: 1
durationMs: 12450
snapshot:
id: snap-uuid
consistent: true
drift: null
'202':
description: REST/Gateway call accepted as async job. Poll /api/jobs/:jobId/status and /api/jobs/:jobId/result.
content:
application/json:
example:
success: true
jobId: f8d2d8d4-4f22-4a0a-bec7-a9f05ad6b9e6
status: queued
statusUrl: /api/jobs/f8d2d8d4-4f22-4a0a-bec7-a9f05ad6b9e6/status
resultUrl: /api/jobs/f8d2d8d4-4f22-4a0a-bec7-a9f05ad6b9e6/result
description: '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.'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
gridOperatorId:
type: string
description: MaStR grid operator ID (SNB...)
example: SNB935578300972
gridOperatorBdew:
type: string
description: 13-digit BDEW market-partner code
example: '9907473000008'
gridOperatorName:
type: string
description: Grid operator name (fuzzy match via marketPartners)
example: STROMDAO Netze
datapointTags:
type: array
items:
type: string
description: Tags for datapoint snapshot creation (Weg B)
example:
- stromdao-netze
maxAgeMinutes:
type: integer
default: 120
description: Datapoint freshness threshold in minutes
skipSteps:
type: array
items:
type: integer
description: Pipeline step numbers to skip (e.g. [4] skips EWK benchmark)
example: []
includeCapacityCheck:
type: boolean
default: false
description: Call cernion_connection_capacity_check for headroom data
scenarioAdditions:
type: array
description: Optional What-If installations added virtually for this validation run only.
example:
- id: whatif-pv-1
type: solar
capacityMW: 1.5
voltageLevel: MS
items:
type: object
properties:
id:
type: string
example: whatif-1
type:
type: string
example: solar
capacityKW:
type: number
example: 1500
capacityMW:
type: number
example: 1.5
energietraeger:
type: string
example: solar
voltageLevel:
type: string
example: MS
scenarioCapacityMW:
type: number
description: Optional extra capacity (MW) injected as a synthetic What-If installation.
example: 2.5
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
By MaStR ID:
value:
gridOperatorId: SNB935578300972
datapointTags:
- stromdao-netze
maxAgeMinutes: 120
By BDEW code:
value:
gridOperatorBdew: '9907473000008'
By name:
value:
gridOperatorName: STROMDAO Netze
skipSteps:
- 4
What-If scenario:
value:
gridOperatorId: SNB935578300972
scenarioAdditions:
- id: whatif-pv-1
type: solar
capacityMW: 1.5
voltageLevel: MS
scenarioCapacityMW: 0.8
/api/grid-connection/validations:
get:
summary: List past grid connection validation reports
tags:
- Grid Connection Validation
operationId: grid_connection_list
parameters:
- name: gridOperatorId
in: query
schema:
type: string
example: SNB935578300972
description: Filter by MaStR grid operator ID
- name: limit
in: query
schema:
type: integer
default: 20
maximum: 100
description: Maximum number of results
- name: cursor
in: query
required: false
schema:
type: string
example: eyJvZmZzZXQiOjIwfQ==
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
example: 0
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Paginated list of validation report summaries
content:
application/json:
example:
count: 3
validations:
- id: '...'
gridOperator:
name: STROMDAO Netze
decision: GO_CONDITIONAL
createdAt: 2026-03-30T...
description: Returns validation reports stored in PouchDB, newest first. Filter by gridOperatorId.
/api/grid-connection/validations/:id:
get:
summary: Get a specific validation report by ID
tags:
- Grid Connection Validation
operationId: grid_connection_get
parameters:
- name: id
in: path
required: true
schema:
type: string
example: a1b2c3d4-1234-5678-90ab-cdef12345678
description: Validation report UUID
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Full ValidationReport document
'404':
description: Validation not found
description: Returns the full ValidationReport document including all findings and snapshot reference.
/api/grid-connection/messkonzept/conflict/validate:
post:
summary: Validate PV/storage/heat-pump metering-concept conflict
tags:
- Grid Connection Validation
operationId: grid_connection_validateMesskonzeptConflict
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: Deterministically evaluates the Cernion V1 REST reference case for a reported MK10 meter merge where the target state requires MK40 cascade metering, §14a registration, and explicit separation of a demounted legacy full-feed-in PV system.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
postalCode:
type: string
reportedMeteringConcept:
type: string
legacyPvStatus:
type: string
batteryChargeKW:
type: number
heatPumpKW:
type: number
newPvKWp:
type: number
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
required: []
components:
parameters:
TokenQuery:
name: token
in: query
required: false
schema:
type: string
description: 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.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'