MaStR Data Quality

Run MaStR portfolio quality audit (8-step, deterministic)

Executes a deterministic 8-step MaStR data quality audit for a VNB portfolio: VNB identity → full inventory → status anomalies → capacity anomalies → connection point integrity → duplicate detection → geo spot check → audit trail. Returns a qualityScore (0–100) across 5 weighted dimensions. No LLM involvement — identical inputs always produce identical finding codes. Steps 3–7 can be skipped via the skipSteps parameter; scores are re-normalised. Steps 1, 2, and 8 are mandatory.

post/api/mastr-quality/audit

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/mastr-quality/audit
  • 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

gridOperatorIdstring

MaStR grid operator ID (SNB.../GNB...)

gridOperatorBdewstring

13-digit BDEW market-partner code

gridOperatorNamestring

Grid operator name (fuzzy match)

bdewCodestring

Alias for gridOperatorBdew

gridOperatorBnrstring

Alias BNR input (7/8 digits; tolerant format accepted)

bnrstring

Alias for gridOperatorBnr

datapointTagsstring[]

Tags for datapoint snapshot (Weg B)

maxAgeMinutesinteger

Datapoint freshness threshold in minutes

skipStepsinteger[]

Steps to skip (valid: 3–7; steps 1, 2, 8 are mandatory)

geoSampleSizeinteger

Number of installations to geo-validate in step 7

tokenstring

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

Example request

{
  "gridOperatorId": "SNB935578300972",
  "gridOperatorBdew": "9907473000008",
  "gridOperatorName": "STROMDAO Netze",
  "bdewCode": "9907473000008",
  "gridOperatorBnr": "10002977",
  "bnr": "10002977",
  "datapointTags": [
    "stromdao-netze"
  ],
  "skipSteps": [
    7
  ]
}

Response

Internal (non-gateway) call: direct AuditReport with qualityScore, dimensions, and findings from all executed pipeline steps

Changes

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