---
title: "List assets of a distribution network operator (DNO/DSO)"
method: GET
path: "/api/assets/list"
tags: ["Assets"]
---

# List assets of a distribution network operator (DNO/DSO)

`GET /api/assets/list`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/assets/list`
- Auth: none declared

Retrieves complete installation data from the German Marktstammdatenregister (MaStR). Supports filtering by grid operator (BDEW code or name), asset type, capacity, commissioning year, and operational status. **Default behavior: Only active installations (status 35 - In operation) are returned.** No pagination required - can retrieve millions of installations.

## Query parameters

- `vnbName` string
- `bdewCode` string
- `gridOperatorId` string
- `assetType` 'solar' | 'wind' | 'storage' | 'biomass' | 'hydro' | 'combustion', required
- `location` string
- `commissioningYear` number
- `minCapacityKW` number
- `maxCapacityKW` number
- `limit` number
- `offset` number
- `redispatch` boolean
- `operationalStatus` string
- `netzbetreiberPruefungStatus` string
- `includeNapData` boolean
- `updatedAfter` string, date
- `token` string

## Response `200`

List of installations with complete MaStR data

- object[]
  - `SEE Nummer` string, required: MaStR unit ID (SEE/SBE/SWE format)
  - `Einheit Systemstatus` string, nullable: System status of the unit
  - `Betreiber` string, required: Name of the installation operator
  - `Marktaktuer MaStR` string, nullable: MaStR ID of direct marketer
  - `Marktakteuer Name` string, nullable: Name of direct marketer
  - `Marktakteur Adresse` string, nullable: Address of direct marketer
  - `Netzbetreiber MaStR` string, nullable: MaStR ID of grid operator
  - `Netzbetreiber Name` string, nullable: Name of grid operator
  - `Anlagentyp` 'solar' | 'wind' | 'storage' | 'biomass' | 'hydro' | 'combustion', required: Type of installation
  - `Leistung MW` number, required: Gross capacity in megawatts (MW)
  - `Leistung kW` number: Gross capacity in kilowatts (kW)
  - `Wechselrichterleistung` number, nullable: Inverter capacity in kW (PV/storage only)
  - `Technologie` string, required: Technology type (e.g., solar, wind)
  - `Speicherkapazität` number, nullable: Usable storage capacity in kWh (storage only)
  - `C_Rate` number, nullable: C-Rate for storage (power/capacity)
  - `AC Nennleistung` number, nullable: AC nominal power in kW (storage only)
  - `DC Nennleistung` number, nullable: DC nominal power in kW (storage only)
  - `Batterietechnologie` string, nullable: Battery technology type (storage only)
  - `Hersteller Batteriemodule` string, nullable: Battery module manufacturer (storage only)
  - `Hauptausrichtung` string, nullable: Main orientation (solar only, e.g., Süd, Ost-West)
  - `Neigungswinkel` number, nullable: Tilt angle in degrees (solar only)
  - `Leistungsbegrenzung` string, nullable: Power limitation (solar only)
  - `Nabenhöhe` number, nullable: Hub height in meters (wind only)
  - `Rotordurchmesser` number, nullable: Rotor diameter in meters (wind only)
  - `Hersteller` string, nullable: Manufacturer (wind only)
  - `Typenbezeichnung` string, nullable: Type designation (wind only)
  - `Betriebsstatus` string, nullable: Operational status code: 31=Planned, 35=In operation, 37=Temporarily decommissioned, 38=Permanently decommissioned
  - `Betriebsstatus Name` string, nullable: Operational status name in German
  - `Datum Netzzugang` string, date: Commissioning date (ISO 8601)
  - `Registrierungsdatum` string, date, nullable: Registration date
  - `Genehmigungsdatum` string, date, nullable: Approval date
  - `Kopplung` string, nullable: AC/DC coupling (storage only)
  - `Einspeiseart` string, nullable: Feed-in type (e.g., full feed-in, surplus feed-in)
  - `Spannungsebene` string, nullable: Voltage level (NS/MS/HS)
  - `Fernsteuerbarkeit` string, nullable: Remote controllability
  - `Einsatzverantwortlicher` string, nullable: Deployment responsible party
  - `Postleitzahl` string, nullable: Postal code of installation location
  - `Ort` string, nullable: City of installation location
  - `Gemeinde` string, nullable: Municipality of installation location
  - `Landkreis` string, nullable: District of installation location
  - `Bundesland` string, nullable: Federal state code
  - `Längengrad` number, nullable: Longitude coordinate
  - `Breitengrad` number, nullable: Latitude coordinate
  - `Fläche` number, nullable: Used area in m²
  - `Anzahl Module` number, nullable: Number of modules (solar only)
  - `Leistung je Modul` number, nullable: Power per module in W (solar only)
  - `Netzbetreiberpruefung Status` number, nullable: Grid operator review status code: 2954=Geprüft, 2955=In Prüfung, 3075=Nicht vorgesehen, null=older record
  - `Netzbetreiberpruefung Status Name` string, nullable: Grid operator review status label: Geprüft / In Prüfung / Nicht vorgesehen
  - `NAP MaStR Nummer` string, nullable: MaStR ID of the grid connection point (SAN format)
  - `Messlokation (MeLo)` string, nullable: Metering location ID (DE..., 33 chars)
  - `Spannungsebene NAP` string, nullable: Voltage level at grid connection: Niederspannung / Mittelspannung / Hochspannung / Höchstspannung
  - `Nettoengpassleistung kW` number, nullable: Net bottleneck capacity in kW at grid connection point
  - `Netz MaStR Nummer` string, nullable: MaStR ID of the connected grid (SNE format)
  - `Netzbetreiber NAP MaStR` string, nullable: MaStR ID of the grid operator at the connection point (SNB format)

## Other responses

- `400`: Invalid parameters (missing grid operator details or invalid assetType)
- `500`: Internal server error during MaStR query

---

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