# Cernion Zielnetzplanung (ZNP) API

**Canonical:** https://apis.io/apis/cernion-de/cernion-de-zielnetzplanung-znp-api/  
**Provider:** Cernion — https://apis.io/providers/cernion-de/  
**Base URL:** https://api.cernion.de  
**Documentation:** https://api.cernion.de/api/docs

Cernion Zielnetzplanung (ZNP) API is one of 144 APIs that [Cernion](https://apis.io/providers/cernion-de/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Zielnetzplanung (ZNP). The published artifact set on APIs.io includes an OpenAPI specification.

Stateful workspace API for target grid planning (v0.20.4). Each project is an in-memory graphology graph for a geographic bounding box. Data Layers are loaded iteratively: Layer 0 (MaStR assets), Layer 1 (OSM buildings — stub), Layer 2 (transformer loads — stub). All assets in Layer 0 connect to a virtual substation SUB_1 (MaStR has no topology). Graph state is persisted in PouchDB (meta + graph split docs) and hydrated on service start. Project metadata (bbox, layer counts) is persisted alongside graph topology.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/znp/projects` | Create a new ZNP project workspace |
| GET | `/api/znp/projects` | List all active ZNP projects (in-memory) |
| POST | `/api/znp/projects/:projectId/layer0` | Load Layer 0 — MaStR assets into a ZNP project graph |
| POST | `/api/znp/projects/:projectId/layer1` | Load Layer 1 — OSM spatial buildings and clustering (async job) |
| POST | `/api/znp/projects/:projectId/layer2` | Load Layer 2 — AI-extracted transformer peak load from PDF (async job) |
| GET | `/api/znp/projects/:projectId/g-factor` | Calculate simultaneity factor (G-Factor) for a ZNP project |
| GET | `/api/znp/projects/:projectId/portfolio` | Assess ZNP portfolio with hybrid provenance and transparent dimensions |
| GET | `/api/znp/projects/:projectId/morning-briefing` | Build a read-only ZNP morning briefing for grid planners |
| GET | `/api/znp/projects/:projectId/production-readiness/status` | Read-only ZNP production-readiness evidence gate |
| GET | `/api/znp/projects/:projectId/strategic-prompts` | Generate strategic planning questions for a ZNP project (AI) |
| GET | `/api/znp/projects/:projectId/assets` | List MaStR assets in a ZNP project (paginated) |
| GET | `/api/znp/projects/:projectId` | Get ZNP project metadata and graph statistics |
| DELETE | `/api/znp/projects/:projectId` | Delete a ZNP project permanently |
| POST | `/api/znp/projects/:projectId/assumptions` | Ingest a natural-language planning assumption into the graph (AI) |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/cernion-de/openapi/cernion-de-zielnetzplanung-znp-api-openapi.yml

## Other Cernion APIs (12)

- [Cernion Actor Personas API](https://apis.io/apis/cernion-de/cernion-de-actor-personas-api/)
- [Cernion Agent Manifest API](https://apis.io/apis/cernion-de/cernion-de-agent-manifest-api/)
- [Cernion Agent Receipts API](https://apis.io/apis/cernion-de/cernion-de-agent-receipts-api/)
- [Cernion Agent Sidecar API](https://apis.io/apis/cernion-de/cernion-de-agent-sidecar-api/)
- [Cernion Agnes Bottleneck API](https://apis.io/apis/cernion-de/cernion-de-agnes-bottleneck-api/)
- [Cernion AI Agent API](https://apis.io/apis/cernion-de/cernion-de-ai-agent-api/)
- [Cernion Altdaten Assessment API](https://apis.io/apis/cernion-de/cernion-de-altdaten-assessment-api/)
- [Cernion Analytics API](https://apis.io/apis/cernion-de/cernion-de-analytics-api/)
- [Cernion Assets API](https://apis.io/apis/cernion-de/cernion-de-assets-api/)
- [Cernion Authentication API](https://apis.io/apis/cernion-de/cernion-de-authentication-api/)
- [Cernion Automatisierungsradar API](https://apis.io/apis/cernion-de/cernion-de-automatisierungsradar-api/)
- [Cernion Battery Redispatch Special Gate API](https://apis.io/apis/cernion-de/cernion-de-battery-redispatch-special-gate-api/)

## Tags

Zielnetzplanung (ZNP)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cernion-de/cernion-de-zielnetzplanung-znp-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cernion-de/.