Zielnetzplanung (ZNP)

List MaStR assets in a ZNP project (paginated)

Returns the Layer 0 MaStR asset nodes from the project graph. Supports filtering by status and assetType, sorting by capacity, and offset/limit pagination. Strategic assumption nodes (Layer 2.5) are excluded — use a dedicated assumptions endpoint for those.

get/api/znp/projects/:projectId/assets

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/znp/projects/:projectId/assets
  • Auth: none declared

Path parameters

projectIdstring required
Example:a1b2c3d4-0000-0000-0000-000000000001

Query parameters

statusstring
Example:InBetrieb

Filter by asset status (exact string match).

assetTypestring
Example:solar

Filter by asset type (exact string match).

limitinteger
Example:100

Maximum number of results to return (1–1000).

offsetinteger

Zero-based offset for pagination.

sortByCapacity'asc' | 'desc'
Example:desc

Sort direction by capacity (kW). Default: desc (highest capacity first).

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.

Response

Paginated asset list

totalCountinteger
offsetinteger
limitinteger

Example response

{
  "totalCount": 42,
  "limit": 100,
  "assets": [
    {
      "mastrNummer": "SEE900123456789",
      "capacity": 10.5,
      "assetType": "solar",
      "status": "InBetrieb",
      "commissioningDate": "2024-06-15",
      "lat": 49.491,
      "lon": 8.471
    }
  ]
}

Changes

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