Grid Operations

Lookup VNBs and planning regions by coordinates/postcode/community

Lookup VNBs and planning regions using VNBdigital. Provide one of:

  • coordinates for geolocation lookup
  • postcodeId from vnbdigital_search
  • communityId from vnbdigital_search
post/api/grid-operations/vnbdigital-lookup

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/grid-operations/vnbdigital-lookup
  • Auth: none declared

Query parameters

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.

Request body

searchType'coordinates' | 'postcode' | 'community' required

Lookup type

coordinatesstring

Latitude,Longitude (required for coordinates search)

postcodeIdstring

Postcode ID from vnbdigital_search (required for postcode search)

communityIdstring

Community ID from vnbdigital_search (required for community search)

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "searchType": "coordinates",
  "coordinates": "49.34206,8.80022",
  "postcodeId": "DEBWhk01000gMZ1V",
  "communityId": "DEBWhk01000gMZ2A",
  "filter": {
    "onlyNap": false,
    "voltageTypes": [
      "Niederspannung"
    ],
    "withRegions": true
  }
}

Response

VNBdigital lookup result with regions and VNB list

searchTypestring
coordinatesstring
postcodeIdstring
communityIdstring

Changes

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