Assets

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

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.

get/api/assets/list

Request

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

Query parameters

vnbNamestring
Example:Netze BW

Name of the distribution network operator (fuzzy matching supported)

bdewCodestring
Example:4041407000008

BDEW code (13 digits) - more precise than name

gridOperatorIdstring
Example:SNB948311994307

MaStR grid operator ID (SNB/GNB format) - direct ID without resolution

assetType'solar' | 'wind' | 'storage' | 'biomass' | 'hydro' | 'combustion' required
Example:solar

Asset type: solar (PV), wind, storage (battery), biomass (biogas), hydro (hydropower), combustion

locationstring
Example:Heidelberg

City/region/postal code for geographic filtering (optional)

commissioningYearnumber
Example:2020

Filter by commissioning year (optional)

minCapacityKWnumber
Example:100

Minimum capacity in kW (optional)

maxCapacityKWnumber
Example:10000

Maximum capacity in kW (optional)

limitnumber
Example:1000

Max. number of results. Default: 1,000. Use a high value (e.g. 1000000) or all for the complete result set — the server paginates internally.

offsetnumber

Pagination offset — number of records to skip. Use with limit to page through large result sets (e.g. offset=1000&limit=1000 fetches records 1,001–2,000).

redispatchboolean
Example:true

Redispatch 2.0 filter: Only installations ≥100kW (automatically sets minCapacityKW=100)

operationalStatusstring
Example:35

Operational status: 31=Planned, 35=In operation (default), 37=Temporarily decommissioned, 38=Permanently decommissioned, all=All statuses

netzbetreiberPruefungStatusstring
Example:2955

Filter by grid operator verification status code(s), comma-separated. Values: 2954=Geprüft ✅, 2955=In Prüfung ⏳, 3075=Nicht vorgesehen.

includeNapDataboolean
Example:true

Include NAP data (Netzanschlusspunkt): MeLo, voltage level, grid bottleneck capacity. Default: true. Set to false to speed up large queries.

updatedAfterstring date
Example:2026-03-24

ISO date (YYYY-MM-DD or full ISO 8601). Returns only installations where DatumLetzteMeldung (MaStR last-notification date) is after this date. Useful for incremental sync.

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

List of installations with complete MaStR data

SEE Nummerstring required

MaStR unit ID (SEE/SBE/SWE format)

Einheit Systemstatusstring nullable

System status of the unit

Betreiberstring required

Name of the installation operator

Marktaktuer MaStRstring nullable

MaStR ID of direct marketer

Marktakteuer Namestring nullable

Name of direct marketer

Marktakteur Adressestring nullable

Address of direct marketer

Netzbetreiber MaStRstring nullable

MaStR ID of grid operator

Netzbetreiber Namestring nullable

Name of grid operator

Anlagentyp'solar' | 'wind' | 'storage' | 'biomass' | 'hydro' | 'combustion' required

Type of installation

Leistung MWnumber required

Gross capacity in megawatts (MW)

Leistung kWnumber

Gross capacity in kilowatts (kW)

Wechselrichterleistungnumber nullable

Inverter capacity in kW (PV/storage only)

Technologiestring required

Technology type (e.g., solar, wind)

Speicherkapazitätnumber nullable

Usable storage capacity in kWh (storage only)

C_Ratenumber nullable

C-Rate for storage (power/capacity)

AC Nennleistungnumber nullable

AC nominal power in kW (storage only)

DC Nennleistungnumber nullable

DC nominal power in kW (storage only)

Batterietechnologiestring nullable

Battery technology type (storage only)

Hersteller Batteriemodulestring nullable

Battery module manufacturer (storage only)

Hauptausrichtungstring nullable

Main orientation (solar only, e.g., Süd, Ost-West)

Neigungswinkelnumber nullable

Tilt angle in degrees (solar only)

Leistungsbegrenzungstring nullable

Power limitation (solar only)

Nabenhöhenumber nullable

Hub height in meters (wind only)

Rotordurchmessernumber nullable

Rotor diameter in meters (wind only)

Herstellerstring nullable

Manufacturer (wind only)

Typenbezeichnungstring nullable

Type designation (wind only)

Betriebsstatusstring nullable

Operational status code: 31=Planned, 35=In operation, 37=Temporarily decommissioned, 38=Permanently decommissioned

Betriebsstatus Namestring nullable

Operational status name in German

Datum Netzzugangstring date

Commissioning date (ISO 8601)

Registrierungsdatumstring date nullable

Registration date

Genehmigungsdatumstring date nullable

Approval date

Kopplungstring nullable

AC/DC coupling (storage only)

Einspeiseartstring nullable

Feed-in type (e.g., full feed-in, surplus feed-in)

Spannungsebenestring nullable

Voltage level (NS/MS/HS)

Fernsteuerbarkeitstring nullable

Remote controllability

Einsatzverantwortlicherstring nullable

Deployment responsible party

Postleitzahlstring nullable

Postal code of installation location

Ortstring nullable

City of installation location

Gemeindestring nullable

Municipality of installation location

Landkreisstring nullable

District of installation location

Bundeslandstring nullable

Federal state code

Längengradnumber nullable

Longitude coordinate

Breitengradnumber nullable

Latitude coordinate

Flächenumber nullable

Used area in m²

Anzahl Modulenumber nullable

Number of modules (solar only)

Leistung je Modulnumber nullable

Power per module in W (solar only)

Netzbetreiberpruefung Statusnumber nullable

Grid operator review status code: 2954=Geprüft, 2955=In Prüfung, 3075=Nicht vorgesehen, null=older record

Netzbetreiberpruefung Status Namestring nullable

Grid operator review status label: Geprüft / In Prüfung / Nicht vorgesehen

NAP MaStR Nummerstring nullable

MaStR ID of the grid connection point (SAN format)

Messlokation (MeLo)string nullable

Metering location ID (DE..., 33 chars)

Spannungsebene NAPstring nullable

Voltage level at grid connection: Niederspannung / Mittelspannung / Hochspannung / Höchstspannung

Nettoengpassleistung kWnumber nullable

Net bottleneck capacity in kW at grid connection point

Netz MaStR Nummerstring nullable

MaStR ID of the connected grid (SNE format)

Netzbetreiber NAP MaStRstring nullable

MaStR ID of the grid operator at the connection point (SNB format)

Example response

[
  {
    "SEE Nummer": "SEE913735587817",
    "Betreiber": "PVA Langenenslingen",
    "Leistung MW": 80.3088,
    "Leistung kW": 80308.8,
    "Technologie": "solar",
    "Betriebsstatus": "35",
    "Betriebsstatus Name": "In Betrieb",
    "Datum Netzzugang": "2025-05-27",
    "Einspeiseart": "Überschusseinspeisung",
    "Postleitzahl": "88515",
    "Ort": "Langenenslingen",
    "Gemeinde": "Langenenslingen",
    "Landkreis": "Biberach",
    "Bundesland": "1402",
    "Netzbetreiberpruefung Status": 2954,
    "Netzbetreiberpruefung Status Name": "Geprüft",
    "NAP MaStR Nummer": "SAN914634531048",
    "Messlokation (MeLo)": "DE0003976706990000000000000073131",
    "Spannungsebene NAP": "Niederspannung (LV)",
    "Nettoengpassleistung kW": 6.15,
    "Netz MaStR Nummer": "SNE985057905075",
    "Netzbetreiber NAP MaStR": "SNB935578300972"
  }
]

Changes

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