Customer Service

Compare actual vs. expected yield and diagnose performance issues

Health status: EXCELLENT (>95%), GOOD (90-95%), ACCEPTABLE (85-90%), POOR (70-85%), CRITICAL (<70%)

post/api/customer-service/installation-health-check

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/customer-service/installation-health-check
  • 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

capacityKWpnumber required

Installation capacity in kWp

commissioningYearnumber required

Year of commissioning

postalCodestring required

German postal code (5 digits)

actualYieldKWhnumber required

Actual energy yield in kWh

yieldPeriod'month' | 'year' required

Period for the actualYieldKWh value

yieldYearnumber

Optional: Specific year for the yield measurement

tokenstring

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

Example request

{
  "capacityKWp": 9.8,
  "commissioningYear": 2015,
  "postalCode": "80331",
  "actualYieldKWh": 8500,
  "yieldPeriod": "year",
  "yieldYear": 2025
}

Response

Successful response

object required

Changes

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