Deterministic fNAV feasibility assessment (v0.51.5): capacity model (firm + flexible + curtailment), N-1 check with hybrid threshold (domain default + tenant/project/scenario override), technical feasibility verdict, governance gate (Option B: requires_governance_decision until legal + contract prerequisites met), and TOTEX-based economics with eog-calculator integration.
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-netzfahrplan-fnav-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 Netzfahrplan / fNAV 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: Netzfahrplan / fNAV
description: 'Deterministic fNAV feasibility assessment (v0.51.5): capacity model (firm + flexible + curtailment), N-1 check with hybrid threshold (domain default + tenant/project/scenario override), technical feasibility verdict, governance gate (Option B: requires_governance_decision until legal + contract prerequisites met), and TOTEX-based economics with eog-calculator integration.'
paths:
/api/grid-operations/netzfahrplan/generate:
post:
summary: Generate Netzfahrplan / fNAV feasibility assessment
tags:
- Netzfahrplan / fNAV
operationId: grid_operations_netzfahrplanGenerate
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: fNAV feasibility assessment result
content:
application/json:
schema:
type: object
properties:
capacityModel:
type: object
description: Normalised capacity model
n1Check:
type: object
description: N-1 compliance result
feasibility:
type: string
enum:
- feasible
- conditional
- copper_needed
description: Technical feasibility verdict
governanceStatus:
type: string
description: Governance decision status
governanceBlockers:
type: array
items:
type: string
contractGate:
type: object
description: Explicit contract-gate assessment for grid-signal priority and control evidence
governanceArtifact:
type:
- object
- 'null'
description: Optional interface-placeholder / HITL artifact created for governance blockers
decisionChain:
type: array
items:
type: object
description: Additive six-step A²MDM trace for the Phase-5 decision
proof:
type: object
description: Compact proof/provenance payload for audit-friendly handoff
findings:
type: array
items:
type: object
metadata:
type: object
description: 'Deterministic fNAV feasibility assessment — evaluates whether a flexible Netzanschlussvertrag (§14a EnWG) is a viable alternative to conventional grid expansion.
**Capacity model (Option B):**
- firmCapacityKW: guaranteed, contractually fixed power
- flexibleCapacityKW: legally curtailable portion under §14a
- resultingEffectiveCapacityKW: firm + flexible × (1 − curtailmentFactor)
**N-1 threshold (Option C — hybrid default + override):**
- Domain defaults: HS=81 MVA, MS=20 MVA, NS=0.63 MVA (env-configurable)
- tenant/project/scenario overrides are applied in priority order
- Result always reports thresholdMVA, thresholdSource, and overrideApplied
**Governance (Option B):**
- Technical feasibility is reported deterministically
- Final governanceStatus is `requires_governance_decision` until legalStatus=approved AND contractStatus=signed
- Flexible profiles should explicitly document Netzsignal-Vorrang plus a control-evidence reference for the contract gate'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- requestedCapacityKW
properties:
gridOperatorId:
type: string
description: MaStR grid operator ID
example: SNB935578300972
gridOperatorName:
type: string
description: Grid operator name
example: STROMDAO Netze
voltageLevel:
type: string
enum:
- NS
- MS
- HS
default: MS
description: Voltage level of the connection point
requestedCapacityKW:
type: number
description: Requested connection capacity in kW
example: 5000
firmCapacityKW:
type: number
description: Guaranteed firm capacity in kW (defaults to requestedCapacityKW if omitted)
example: 3000
flexibleCapacityKW:
type: number
default: 0
description: Curtailable flex capacity in kW under §14a
example: 2000
curtailmentWindow:
type: number
default: 0
description: Max hours per day the VNB may curtail (0–24)
example: 4
operatingConstraint:
type: string
description: Free-text operating constraint
example: §14a max 2h/event, 30-min notice
signalPriorityPolicy:
type: string
description: Optional contract-gate wording that explicitly documents grid-signal priority over schedule/market optimisation
example: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef:
type: string
description: Optional reference to the control/remote-control evidence backing the contract gate
example: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus:
type: string
description: Contract status
example: negotiating
legalStatus:
type: string
description: Legal/regulatory status
example: pending
ownerContact:
type: string
description: Responsible owner or contact (required for governance approval)
example: netzplanung@stromdao.de
n1ThresholdOverride:
type: object
example:
project: 78
description: Override N-1 thresholds (MVA) at tenant/project/scenario level
properties:
tenant:
type: number
example: 85
project:
type: number
example: 78
scenario:
type: number
example: 70
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
fNAV hybrid MS:
value:
gridOperatorName: STROMDAO Netze
voltageLevel: MS
requestedCapacityKW: 5000
firmCapacityKW: 3000
flexibleCapacityKW: 2000
curtailmentWindow: 4
operatingConstraint: §14a max 2h/event
signalPriorityPolicy: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus: negotiating
legalStatus: pending
ownerContact: netzplanung@stromdao.de
static cap HS with override:
value:
gridOperatorId: SNB935578300972
voltageLevel: HS
requestedCapacityKW: 75000
firmCapacityKW: 75000
contractStatus: signed
legalStatus: approved
n1ThresholdOverride:
project: 78
/api/grid-connection/fnav/validate:
post:
summary: Validate fNAV profile against grid connection capacity (Phase 5)
tags:
- Netzfahrplan / fNAV
operationId: grid_connection_fnavValidate
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: fNAV validation result with capacity model, N-1 check, and governance status
content:
application/json:
schema:
type: object
properties:
capacityModel:
type: object
description: Normalised fNAV capacity model
n1Check:
type: object
description: N-1 compliance result
feasibility:
type: string
enum:
- feasible
- conditional
- copper_needed
governanceStatus:
type: string
governanceBlockers:
type: array
items:
type: string
contractGate:
type: object
description: Explicit contract-gate assessment
governanceArtifact:
type:
- object
- 'null'
decisionChain:
type: array
items:
type: object
proof:
type: object
findings:
type: array
items:
type: object
metadata:
type: object
source:
type: string
description: 'Applies the fNAV capacity model (§14a EnWG) for a proposed grid connection. Runs N-1 compliance check with hybrid threshold (Option C: domain default + tenant/project/scenario override). Reports technical feasibility and enforces governance gate (Option B: final status is requires_governance_decision until legalStatus=approved AND contractStatus=signed). Delegates to grid-operations.netzfahrplanGenerate for the deterministic core.'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- fnavProfile
properties:
gridOperatorName:
type: string
example: STROMDAO Netze
voltageLevel:
type: string
enum:
- NS
- MS
- HS
default: MS
description: Voltage level of the connection point
fnavProfile:
type: object
example:
requestedCapacity: 5000
firmCapacity: 3000
flexibleCapacity: 2000
curtailmentWindow: 4
signalPriorityPolicy: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus: negotiating
legalStatus: pending
required:
- requestedCapacity
properties:
requestedCapacity:
type: number
example: 5000
description: Requested capacity in kW
firmCapacity:
type: number
example: 3000
description: Guaranteed firm capacity in kW
flexibleCapacity:
type: number
example: 2000
description: Curtailable §14a flex capacity in kW
curtailmentWindow:
type: number
example: 4
description: Max curtailment hours per day (0–24)
operatingConstraint:
type: string
example: §14a max 2h/event
signalPriorityPolicy:
type: string
example: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef:
type: string
example: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus:
type: string
example: negotiating
legalStatus:
type: string
example: pending
n1ThresholdOverride:
type: object
example:
project: 78
description: Override N-1 threshold (MVA) at tenant/project/scenario level
properties:
tenant:
type: number
example: 85
project:
type: number
example: 78
scenario:
type: number
example: 70
ownerContact:
type: string
example: netzplanung@stromdao.de
description: Responsible owner — required for governance approval
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
fNAV hybrid MS:
value:
gridOperatorName: STROMDAO Netze
voltageLevel: MS
fnavProfile:
requestedCapacity: 5000
firmCapacity: 3000
flexibleCapacity: 2000
curtailmentWindow: 4
signalPriorityPolicy: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus: signed
legalStatus: approved
ownerContact: netzplanung@stromdao.de
/api/finance-agent/fnav/economics:
post:
summary: 'Calculate fNAV economics: avoided CAPEX, annual fee, payback (Phase 5)'
tags:
- Netzfahrplan / fNAV
operationId: finance_agent_fnavEconomics
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: fNAV economics result
content:
application/json:
schema:
type: object
properties:
avoidedCopperCapexEur:
type: number
annualFeeEur:
type: number
paybackYears:
type: number
capexSource:
type: string
enum:
- eog_calculator
- parametric_fallback
- override
sensitivityFlags:
type: array
items:
type: string
governanceStatus:
type: string
governanceBlockers:
type: array
items:
type: string
contractGate:
type: object
description: Explicit contract-gate assessment
governanceArtifact:
type:
- object
- 'null'
decisionChain:
type: array
items:
type: object
proof:
type: object
findings:
type: array
items:
type: object
metadata:
type: object
description: 'Deterministic fNAV economics assessment. Computes:
- avoidedCopperCapexEur: cost of conventional grid expansion avoided by fNAV
- annualFeeEur: recurring cost of the fNAV contract
- paybackYears: avoidedCapex / annualFee
- sensitivityFlags: qualitative flags for high uncertainty inputs
Option B: calls eog-calculator.capexEstimate for TOTEX-based CAPEX reference; if unavailable, uses parametric fallback (FN_ECONOMICS_PARTIAL).
Governance Option B: governanceStatus is always requires_governance_decision until legalStatus=approved AND contractStatus=signed.'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- fnavProfile
properties:
fnavProfile:
type: object
example:
requestedCapacity: 5000
firmCapacity: 3000
flexibleCapacity: 2000
curtailmentWindow: 4
signalPriorityPolicy: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus: negotiating
legalStatus: pending
required:
- requestedCapacity
properties:
requestedCapacity:
type: number
example: 5000
description: Requested capacity kW
firmCapacity:
type: number
example: 3000
flexibleCapacity:
type: number
example: 2000
curtailmentWindow:
type: number
example: 4
signalPriorityPolicy:
type: string
example: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef:
type: string
example: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus:
type: string
example: negotiating
legalStatus:
type: string
example: pending
voltageLevel:
type: string
enum:
- NS
- MS
- HS
default: MS
gridOperator:
type: string
example: STROMDAO Netze
description: Used for eog-calculator lookup
annualFeeEur:
type: number
example: 12000
description: Annual fNAV contract fee (EUR/yr)
ownerContact:
type: string
example: netzplanung@stromdao.de
avoidedCapexOverrideEur:
type: number
example: 1500000
description: Override avoided CAPEX (EUR)
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
fNAV economics — STROMDAO Netze MS:
value:
fnavProfile:
requestedCapacity: 5000
firmCapacity: 3000
flexibleCapacity: 2000
curtailmentWindow: 4
signalPriorityPolicy: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus: signed
legalStatus: approved
voltageLevel: MS
gridOperator: STROMDAO Netze
annualFeeEur: 15000
ownerContact: netzplanung@stromdao.de
/api/netzfahrplan/generate:
post:
summary: Generate Netzfahrplan / fNAV feasibility assessment
tags:
- Netzfahrplan / fNAV
operationId: postApiNetzfahrplanGenerate
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: fNAV feasibility assessment result
content:
application/json:
schema:
type: object
properties:
capacityModel:
type: object
description: Normalised capacity model
n1Check:
type: object
description: N-1 compliance result
feasibility:
type: string
enum:
- feasible
- conditional
- copper_needed
description: Technical feasibility verdict
governanceStatus:
type: string
description: Governance decision status
governanceBlockers:
type: array
items:
type: string
contractGate:
type: object
description: Explicit contract-gate assessment for grid-signal priority and control evidence
governanceArtifact:
type:
- object
- 'null'
description: Optional interface-placeholder / HITL artifact created for governance blockers
decisionChain:
type: array
items:
type: object
description: Additive six-step A²MDM trace for the Phase-5 decision
proof:
type: object
description: Compact proof/provenance payload for audit-friendly handoff
findings:
type: array
items:
type: object
metadata:
type: object
description: 'Deterministic fNAV feasibility assessment — evaluates whether a flexible Netzanschlussvertrag (§14a EnWG) is a viable alternative to conventional grid expansion.
**Capacity model (Option B):**
- firmCapacityKW: guaranteed, contractually fixed power
- flexibleCapacityKW: legally curtailable portion under §14a
- resultingEffectiveCapacityKW: firm + flexible × (1 − curtailmentFactor)
**N-1 threshold (Option C — hybrid default + override):**
- Domain defaults: HS=81 MVA, MS=20 MVA, NS=0.63 MVA (env-configurable)
- tenant/project/scenario overrides are applied in priority order
- Result always reports thresholdMVA, thresholdSource, and overrideApplied
**Governance (Option B):**
- Technical feasibility is reported deterministically
- Final governanceStatus is `requires_governance_decision` until legalStatus=approved AND contractStatus=signed
- Flexible profiles should explicitly document Netzsignal-Vorrang plus a control-evidence reference for the contract gate'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- requestedCapacityKW
properties:
gridOperatorId:
type: string
description: MaStR grid operator ID
example: SNB935578300972
gridOperatorName:
type: string
description: Grid operator name
example: STROMDAO Netze
voltageLevel:
type: string
enum:
- NS
- MS
- HS
default: MS
description: Voltage level of the connection point
requestedCapacityKW:
type: number
description: Requested connection capacity in kW
example: 5000
firmCapacityKW:
type: number
description: Guaranteed firm capacity in kW (defaults to requestedCapacityKW if omitted)
example: 3000
flexibleCapacityKW:
type: number
default: 0
description: Curtailable flex capacity in kW under §14a
example: 2000
curtailmentWindow:
type: number
default: 0
description: Max hours per day the VNB may curtail (0–24)
example: 4
operatingConstraint:
type: string
description: Free-text operating constraint
example: §14a max 2h/event, 30-min notice
signalPriorityPolicy:
type: string
description: Optional contract-gate wording that explicitly documents grid-signal priority over schedule/market optimisation
example: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef:
type: string
description: Optional reference to the control/remote-control evidence backing the contract gate
example: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus:
type: string
description: Contract status
example: negotiating
legalStatus:
type: string
description: Legal/regulatory status
example: pending
ownerContact:
type: string
description: Responsible owner or contact (required for governance approval)
example: netzplanung@stromdao.de
n1ThresholdOverride:
type: object
example:
project: 78
description: Override N-1 thresholds (MVA) at tenant/project/scenario level
properties:
tenant:
type: number
example: 85
project:
type: number
example: 78
scenario:
type: number
example: 70
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
fNAV hybrid MS:
value:
gridOperatorName: STROMDAO Netze
voltageLevel: MS
requestedCapacityKW: 5000
firmCapacityKW: 3000
flexibleCapacityKW: 2000
curtailmentWindow: 4
operatingConstraint: §14a max 2h/event
signalPriorityPolicy: Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung
controlEvidenceRef: SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05
contractStatus: negotiating
legalStatus: pending
ownerContact: netzplanung@stromdao.de
static cap HS with override:
value:
gridOperatorId: SNB935578300972
voltageLevel: HS
requestedCapacityKW: 75000
firmCapacityKW: 75000
contractStatus: signed
legalStatus: approved
n1ThresholdOverride:
project: 78
x-operation-id-source: normalized
x-operation-id-original: grid_operations_netzfahrplanGenerate
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.'