Cernion

Cernion EOG Calculator API

The EOG Calculator API from Cernion — 9 operation(s) for eog calculator.

GitHub OpenAPI

Operations 9

POST /api/eog-calculator/input-status Check EOG input coverage for a tenant/VNB scope #
POST /api/eog-calculator/datapoints/validate Validate submitted EOG datapoints without persisting them #
POST /api/eog-calculator/datapoints/commit Commit EOG datapoints only after successful validation or explicit HITL… #
POST /api/eog-calculator/calculate Calculate EOG for actual data scope #
POST /api/eog-calculator/scenario Run transient EOG scenario with overrides (no persistence) #
POST /api/eog-calculator/request-input Create HITL items for missing EOG inputs with blocker explanation #
GET /api/eog-calculator/:tenantId/:vnbId Get persisted EOG model (datapoints + decision events + provenance) #
POST /api/eog-calculator/validate-datapoints Validate submitted EOG datapoints without persisting them #
POST /api/eog-calculator/commit-datapoints Commit EOG datapoints only after successful validation or explicit HITL… #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/cernion-de/openapi/cernion-de-eog-calculator-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-eog-calculator-api"
All apis 
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.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cernion-de-eog-calculator-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Cernion Energy Tools EOG Calculator 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: EOG Calculator
paths:
  /api/eog-calculator/input-status:
    post:
      summary: Check EOG input coverage for a tenant/VNB scope
      tags:
      - EOG Calculator
      operationId: eog_calculator_inputStatus
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      description: Reports required fields, optional-but-relevant fields, and calibration anchors. optionalButRelevant includes quality_element, regulatory_account_balance, capex_adjustment_*, and volatile_costs which are needed for accurate detail reproduction.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tenantId
              - vnbId
              properties:
                tenantId:
                  type: string
                  example: tenant-a
                vnbId:
                  type: string
                  example: SNB100
                periodYear:
                  type: integer
                  example: 2026
                sector:
                  type: string
                  enum:
                  - strom
                  - gas
                  example: strom
                regulatoryPeriod:
                  type: string
                  example: RP3
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  tenantId: tenant-a
                  vnbId: SNB100
                  periodYear: 2026
                  sector: strom
  /api/eog-calculator/datapoints/validate:
    post:
      summary: Validate submitted EOG datapoints without persisting them
      tags:
      - EOG Calculator
      operationId: eog_calculator_validateDatapoints
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tenantId
              - vnbId
              - datapoints
              properties:
                tenantId:
                  type: string
                  example: tenant-a
                vnbId:
                  type: string
                  example: SNB100
                datapoints:
                  type: array
                  items:
                    type: object
                  example:
                  - key: eog.base_cost_level
                    value: 1000
                    periodYear: 2026
                    sector: strom
                    source: tenant_uploaded
                    confidence: confirmed
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  tenantId: tenant-a
                  vnbId: SNB100
                  datapoints:
                  - key: eog.base_cost_level
                    value: 1000
                    periodYear: 2026
                    sector: strom
                    source: tenant_uploaded
                    confidence: confirmed
  /api/eog-calculator/datapoints/commit:
    post:
      summary: Commit EOG datapoints only after successful validation or explicit HITL…
      tags:
      - EOG Calculator
      operationId: eog_calculator_commitDatapoints
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - validationId
              properties:
                validationId:
                  type: string
                  example: validation-uuid
                hitlConfirmation:
                  type: object
                  example:
                    approved: true
                    decision: manual_confirm
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  validationId: validation-uuid
                  hitlConfirmation:
                    approved: true
                    decision: manual_confirm
  /api/eog-calculator/calculate:
    post:
      summary: Calculate EOG for actual data scope
      tags:
      - EOG Calculator
      operationId: eog_calculator_calculate
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tenantId
              - vnbId
              properties:
                tenantId:
                  type: string
                  example: tenant-a
                vnbId:
                  type: string
                  example: SNB100
                periodYear:
                  type: integer
                  example: 2026
                sector:
                  type: string
                  enum:
                  - strom
                  - gas
                  example: strom
                regulatoryPeriod:
                  type: string
                  example: RP3
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  tenantId: tenant-a
                  vnbId: SNB100
                  periodYear: 2026
                  sector: strom
  /api/eog-calculator/scenario:
    post:
      summary: Run transient EOG scenario with overrides (no persistence)
      tags:
      - EOG Calculator
      operationId: eog_calculator_scenario
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tenantId
              - vnbId
              - overrides
              properties:
                tenantId:
                  type: string
                  example: tenant-a
                vnbId:
                  type: string
                  example: SNB100
                periodYear:
                  type: integer
                  example: 2026
                sector:
                  type: string
                  enum:
                  - strom
                  - gas
                  example: strom
                regulatoryPeriod:
                  type: string
                  example: RP3
                overrides:
                  type: array
                  items:
                    type: object
                  example:
                  - key: eog.quality_element
                    value: 50
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  tenantId: tenant-a
                  vnbId: SNB100
                  overrides:
                  - key: eog.quality_element
                    value: 50
  /api/eog-calculator/request-input:
    post:
      summary: Create HITL items for missing EOG inputs with blocker explanation
      tags:
      - EOG Calculator
      operationId: eog_calculator_requestInput
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tenantId
              - vnbId
              properties:
                tenantId:
                  type: string
                  example: tenant-a
                vnbId:
                  type: string
                  example: SNB100
                periodYear:
                  type: integer
                  example: 2026
                sector:
                  type: string
                  enum:
                  - strom
                  - gas
                  example: strom
                regulatoryPeriod:
                  type: string
                  example: RP3
                missingKeys:
                  type: array
                  items:
                    type: string
                  example:
                  - eog.efficiency_value
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  tenantId: tenant-a
                  vnbId: SNB100
                  missingKeys:
                  - eog.efficiency_value
  /api/eog-calculator/:tenantId/:vnbId:
    get:
      summary: Get persisted EOG model (datapoints + decision events + provenance)
      tags:
      - EOG Calculator
      operationId: eog_calculator_getModel
      parameters:
      - name: tenantId
        in: path
        required: true
        schema:
          type: string
          example: tenant-a
      - name: vnbId
        in: path
        required: true
        schema:
          type: string
          example: SNB100
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
  /api/eog-calculator/validate-datapoints:
    post:
      summary: Validate submitted EOG datapoints without persisting them
      tags:
      - EOG Calculator
      operationId: postApiEogCalculatorValidateDatapoints
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tenantId
              - vnbId
              - datapoints
              properties:
                tenantId:
                  type: string
                  example: tenant-a
                vnbId:
                  type: string
                  example: SNB100
                datapoints:
                  type: array
                  items:
                    type: object
                  example:
                  - key: eog.base_cost_level
                    value: 1000
                    periodYear: 2026
                    sector: strom
                    source: tenant_uploaded
                    confidence: confirmed
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  tenantId: tenant-a
                  vnbId: SNB100
                  datapoints:
                  - key: eog.base_cost_level
                    value: 1000
                    periodYear: 2026
                    sector: strom
                    source: tenant_uploaded
                    confidence: confirmed
      x-operation-id-source: normalized
      x-operation-id-original: eog_calculator_validateDatapoints
  /api/eog-calculator/commit-datapoints:
    post:
      summary: Commit EOG datapoints only after successful validation or explicit HITL…
      tags:
      - EOG Calculator
      operationId: postApiEogCalculatorCommitDatapoints
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - validationId
              properties:
                validationId:
                  type: string
                  example: validation-uuid
                hitlConfirmation:
                  type: object
                  example:
                    approved: true
                    decision: manual_confirm
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  validationId: validation-uuid
                  hitlConfirmation:
                    approved: true
                    decision: manual_confirm
      x-operation-id-source: normalized
      x-operation-id-original: eog_calculator_commitDatapoints
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.'