Deterministic 8-step MaStR portfolio quality audit (v0.17). Audits the entire VNB portfolio in MaStR: 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. Steps 3–7 independently skippable via skipSteps parameter.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-mastr-data-quality-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cernion Energy Tools MaStR Data Quality API
version: 0.99.22
description: 'MicroService Agent System for Energy Markets - REST API with AI integration.
CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.
For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
description: API Server
tags:
- name: MaStR Data Quality
description: 'Deterministic 8-step MaStR portfolio quality audit (v0.17). Audits the entire VNB portfolio in MaStR: 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. Steps 3–7 independently skippable via skipSteps parameter.'
paths:
/api/mastr-quality/audit:
post:
summary: Run MaStR portfolio quality audit (8-step, deterministic)
tags:
- MaStR Data Quality
operationId: mastr_quality_audit
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: 'Internal (non-gateway) call: direct AuditReport with qualityScore, dimensions, and findings from all executed pipeline steps'
content:
application/json:
example:
success: true
id: a1b2c3d4-...
qualityScore: 82
qualityDimensions:
status:
score: 90
findings: 2
capacity:
score: 85
findings: 3
connectionPoints:
score: 70
findings: 5
duplicates:
score: 100
findings: 0
geo:
score: 80
findings: 4
summary:
totalInstallations: 142
findingsCount:
info: 5
warning: 8
error: 2
missingNapFindings: 6
missingNapDistinctAssets: 4
missingNapRedispatchFindings: 3
missingNapRedispatchDistinctAssets: 3
napFindings:
missingNapFindings: 6
missingNapDistinctAssets: 4
missingNapRedispatchFindings: 3
missingNapRedispatchDistinctAssets: 3
distinctAssetsAffected: 4
perAssetFindingCount:
SEE900000001: 2
SEE900000002: 1
duplicateByAsset:
SEE900000001: 2
durationMs: 45230
'202':
description: REST/Gateway call accepted as async job. Poll /api/jobs/:jobId/status and /api/jobs/:jobId/result.
content:
application/json:
example:
success: true
jobId: f8d2d8d4-4f22-4a0a-bec7-a9f05ad6b9e6
status: queued
statusUrl: /api/jobs/f8d2d8d4-4f22-4a0a-bec7-a9f05ad6b9e6/status
resultUrl: /api/jobs/f8d2d8d4-4f22-4a0a-bec7-a9f05ad6b9e6/result
description: '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.'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
gridOperatorId:
type: string
description: MaStR grid operator ID (SNB.../GNB...)
example: SNB935578300972
gridOperatorBdew:
type: string
description: 13-digit BDEW market-partner code
example: '9907473000008'
gridOperatorName:
type: string
description: Grid operator name (fuzzy match)
example: STROMDAO Netze
bdewCode:
type: string
description: Alias for gridOperatorBdew
example: '9907473000008'
gridOperatorBnr:
type: string
description: Alias BNR input (7/8 digits; tolerant format accepted)
example: '10002977'
bnr:
type: string
description: Alias for gridOperatorBnr
example: '10002977'
datapointTags:
type: array
items:
type: string
description: Tags for datapoint snapshot (Weg B)
example:
- stromdao-netze
maxAgeMinutes:
type: integer
default: 120
description: Datapoint freshness threshold in minutes
skipSteps:
type: array
items:
type: integer
description: 'Steps to skip (valid: 3–7; steps 1, 2, 8 are mandatory)'
example:
- 7
geoSampleSize:
type: integer
default: 10
maximum: 50
description: Number of installations to geo-validate in step 7
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
By MaStR ID:
value:
gridOperatorId: SNB935578300972
datapointTags:
- stromdao-netze
By BDEW code, skip geo:
value:
gridOperatorBdew: '9907473000008'
skipSteps:
- 7
By name, full audit:
value:
gridOperatorName: STROMDAO Netze
geoSampleSize: 20
/api/mastr-quality/audits:
get:
summary: List past MaStR quality audit reports
tags:
- MaStR Data Quality
operationId: mastr_quality_list
parameters:
- name: gridOperatorId
in: query
schema:
type: string
example: SNB935578300972
description: Filter by MaStR grid operator ID
- name: limit
in: query
schema:
type: integer
default: 20
maximum: 100
description: Maximum number of results
- name: cursor
in: query
required: false
schema:
type: string
example: eyJvZmZzZXQiOjIwfQ==
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
example: 0
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: List of audit report summaries
content:
application/json:
example:
count: 2
audits:
- id: '...'
gridOperator:
name: STROMDAO Netze
qualityScore: 82
createdAt: 2026-03-31T...
description: Returns audit reports stored in PouchDB, newest first. Filter by gridOperatorId.
/api/mastr-quality/audits/:id:
get:
summary: Get a specific MaStR quality audit report by ID
tags:
- MaStR Data Quality
operationId: mastr_quality_get
parameters:
- name: id
in: path
required: true
schema:
type: string
example: a1b2c3d4-1234-5678-90ab-cdef12345678
description: Audit report UUID
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Full AuditReport document
'404':
description: Audit report not found
description: Returns the full AuditReport document including all findings and quality dimensions.
/api/mastr-quality/audits/:id/oemetadata:
get:
summary: Get OEMetadata v2.0 FAIR metadata for an audit report by ID
tags:
- MaStR Data Quality
operationId: mastr_quality_oemetadata
parameters:
- name: id
in: path
required: true
schema:
type: string
example: a1b2c3d4-1234-5678-90ab-cdef12345678
description: Audit report UUID
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: OEMetadata JSON-LD document
'404':
description: Audit report not found
description: Returns a fully OEMetadata v2.0 conformant JSON-LD metadata document.
/api/mastr-quality/audits/:id/findings/:findingId/details:
get:
summary: Get details for a specific finding in an audit
tags:
- MaStR Data Quality
operationId: mastr_quality_findingDetails
parameters:
- name: id
in: path
required: true
schema:
type: string
example: a1b2c3d4-1234-5678-90ab-cdef12345678
description: Audit report UUID
- name: findingId
in: path
required: true
schema:
type: string
example: F-5-002
description: Finding row ID within the audit (findings[].id)
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Finding detail object
content:
application/json:
example:
success: true
auditId: a1b2c3d4-1234-5678-90ab-cdef12345678
findingId: F-5-002
finding:
id: F-5-002
finding: MQ_REDISPATCH_NO_NAP
step: 5
severity: error
context:
mastrNummer: SEE900000001
details:
installation:
mastrNummer: SEE900000001
einheitId: EE123
technology: solar
status: '35'
commissioningDate: '2020-01-15'
brutto: 200
operatorName: Musterbetreiber GmbH
connection:
napId: null
napMastrNummer: null
spannungsebene: null
netzbetreiberName: null
measurement:
melo: null
value: null
rawValue: null
resolvedValue: null
valueSource: null
'404':
description: Audit or finding not found
description: Returns the finding row with enriched standardized detail fields from finding.context.details (installation, connection, measurement).
components:
parameters:
TokenQuery:
name: token
in: query
required: false
schema:
type: string
description: 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.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'