---
title: "Geo-plausibility check for MaStR VNB assignment (L1 authoritative + L2 OSM)"
method: POST
path: "/api/osm-geo/validate"
tags: ["OSM Geo (OpenStreetMap)"]
---

# Geo-plausibility check for MaStR VNB assignment (L1 authoritative + L2 OSM)

`POST /api/osm-geo/validate`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/osm-geo/validate`
- Auth: none declared

Two-layer geographic plausibility check for the grid-operator assignment of a MaStR installation.

**Layer 1 (authoritative):** Coordinate → VNBDigital → expected grid operator for this location.
**Layer 2 (physical):** Coordinate → Overpass API → nearby substations / dominant operator tag.

Detects both **DEFINITIVE_MISASSIGNMENT** (L1 mismatch, authoritative) and **LIKELY_MISASSIGNMENT** (L2 OSM hint only).

**Input:** either `mastrNummer` (coordinates resolved automatically) **or** explicit `latitude` + `longitude`.

**Verdict values:**
- `CONSISTENT` — assignment plausible (L1 + L2 agree or no contradiction)
- `DEFINITIVE_MISASSIGNMENT` — VNBDigital points to a different operator (authoritative correction required)
- `LIKELY_MISASSIGNMENT` — OSM infrastructure tags suggest a different operator
- `UNCERTAIN` — contradictory signals, no clear verdict
- `INSUFFICIENT_DATA` — too few OSM objects for a reliable verdict

**OSM coverage note:** Typically 40–60 % of MS/NS infrastructure is mapped in OSM for Germany. The `dataQuality.coverageLabel` field carries a per-response quality estimate.

**Data:** © OpenStreetMap contributors, [ODbL 1.0](https://opendatacommons.org/licenses/odbl/)

## Query parameters

- `token` string

## Request body

- object
  - `mastrNummer` string: MaStR number (SEE…, SWE…, SBE…). Coordinates and VNB resolved automatically from the local DB.
  - `latitude` number: Latitude — required when mastrNummer is not provided.
  - `longitude` number: Longitude — required when mastrNummer is not provided.
  - `registeredGridOperatorName` string: Registered VNB name for the L1 comparison.
  - `gridOperatorId` string: MaStR ID of the VNB (SNB…).
  - `radiusMeters` number: OSM search radius in metres (max 5 000).
  - `skipOsmLayer` boolean: Only run L1 (no Overpass call). Faster for batch runs.
  - `includeInfrastructureDetails` boolean: Include the full list of found OSM objects in the response.
  - `confidenceThreshold` number: Minimum score for CONSISTENT verdict.
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Validation result returned successfully

---

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