Cernion

Cernion Energy Sharing Community API

The Energy Sharing Community API from Cernion — 5 operation(s) for energy sharing community.

Documentation GitHub OpenAPI

Operations 8

POST /api/energy-sharing-community/communities Create a new Energy Sharing community (#285) #

GET /api/energy-sharing-community/communities List Energy Sharing communities (#285) #

GET /api/energy-sharing-community/communities/:id Get an Energy Sharing community by ID (#285) #

DELETE /api/energy-sharing-community/communities/:id Soft-delete an Energy Sharing community (#285) #

POST /api/energy-sharing-community/communities/:id/members Add a member to an Energy Sharing community (#285) #

PUT /api/energy-sharing-community/communities/:id/members/:memberId Update a community member, e.g. to end their membership via validTo (#285) #

DELETE /api/energy-sharing-community/communities/:id/members/:memberId Hard-remove a member from a community — data-entry correction only (#285) #

GET /api/energy-sharing-community/communities/:id/active-members Resolve active generators/consumers for a date range (#285) #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/cernion-de/openapi/cernion-de-energy-sharing-community-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-energy-sharing-community-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

openapi: 3.2.0
info:
  title: Cernion Energy Tools Energy Sharing Community 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: Energy Sharing Community
paths:
  /api/energy-sharing-community/communities:
    post:
      summary: Create a new Energy Sharing community (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_createCommunity
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Created community
      description: Creates a persistent community record. Add members via POST /communities/:id/members.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  example: PV-Gemeinschaft Musterstraße
                communityId:
                  type: string
                  description: External community ID from VNB
                  example: ES-2026-001
                validationReportId:
                  type: string
                  example: a1b2c3d4-...
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
    get:
      summary: List Energy Sharing communities (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_listCommunities
      parameters:
      - name: includeDeleted
        in: query
        schema:
          type: boolean
          default: false
        description: Include soft-deleted communities (for audit access)
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: List of communities
  /api/energy-sharing-community/communities/:id:
    get:
      summary: Get an Energy Sharing community by ID (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_getCommunity
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Community record
        '404':
          description: Not found
    delete:
      summary: Soft-delete an Energy Sharing community (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_removeCommunity
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Soft-delete confirmed
        '404':
          description: Not found
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
  /api/energy-sharing-community/communities/:id/members:
    post:
      summary: Add a member to an Energy Sharing community (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_addMember
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Updated community with the new member
        '404':
          description: Community not found
      description: 'roles is combinable: ["generator"], ["consumer"], ["storage"], or e.g. ["generator","consumer"] for a Prosumer. "storage" is modelable but not yet fed into allocation arithmetic. validTo is optional (omit for an open-ended membership).'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - roles
              - validFrom
              properties:
                maloId:
                  type: string
                  example: DE0001234567890123456789012345678
                mastrNummer:
                  type: string
                  example: SEE904837264953
                name:
                  type: string
                  example: Müller
                roles:
                  type: array
                  items:
                    type: string
                    enum:
                    - generator
                    - consumer
                    - storage
                generatorSharePercent:
                  type: number
                  example: 100
                consumerSharePercent:
                  type: number
                  example: 30
                validFrom:
                  type: string
                  example: '2026-01-01'
                validTo:
                  type: string
                  example: '2026-12-31'
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              consumer:
                value:
                  maloId: DE0001234567890123456789012345678
                  name: Müller
                  roles:
                  - consumer
                  consumerSharePercent: 30
                  validFrom: '2026-01-01'
              prosumer:
                value:
                  maloId: DE0001234567890123456789012345678
                  mastrNummer: SEE904837264953
                  name: Schmidt
                  roles:
                  - generator
                  - consumer
                  generatorSharePercent: 50
                  consumerSharePercent: 20
                  validFrom: '2026-01-01'
  /api/energy-sharing-community/communities/:id/members/:memberId:
    put:
      summary: Update a community member, e.g. to end their membership via validTo (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_updateMember
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: memberId
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Updated member
        '404':
          description: Community or member not found
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
    delete:
      summary: Hard-remove a member from a community — data-entry correction only (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_removeMember
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: memberId
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Member removed
        '404':
          description: Community or member not found
      description: Removes the member record entirely. To end an active membership normally, use PUT /communities/:id/members/:memberId with validTo instead, which preserves history.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
  /api/energy-sharing-community/communities/:id/active-members:
    get:
      summary: Resolve active generators/consumers for a date range (#285)
      tags:
      - Energy Sharing Community
      operationId: energy_sharing_community_resolveActiveMembers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: dateFrom
        in: query
        required: true
        schema:
          type: string
          example: '2026-06-01'
      - name: dateTo
        in: query
        required: true
        schema:
          type: string
          example: '2026-06-30'
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Active generators/consumers for the period
        '404':
          description: Community not found
      description: A member is active for [dateFrom, dateTo] if their [validFrom, validTo] Teilnahmezeitraum overlaps it. Members whose validTo is before dateFrom are excluded — no manual filtering needed by the caller. No prorating of sharePercent for partial-period membership.
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.'