Cernion EIC Code Management API
The EIC Code Management API from Cernion — 5 operation(s) for eic code management.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-eic-code-management-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.
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 EIC Code Management 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: EIC Code Management
paths:
/api/eic-codes/search:
post:
summary: Search EIC code database by code or company name
tags:
- EIC Code Management
operationId: eic_codes_search
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Search results with matching EIC codes
content:
application/json:
example:
success: true
data:
results:
- code: 21X000000001254A
name: Netze BW GmbH
country: DE
sector: electricity
type: Distribution System Operator
count: 1
limit: 10
text/csv:
description: CSV download (when format=csv)
schema:
type: string
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
description: Excel XLSX download (when format=xlsx or format=xls)
schema:
type: string
format: binary
'400':
description: Validation error - at least code or name required
description: 'Search 72,580+ EIC codes from ENTSO-E and AGSI/GIE.
**At least one of ''code'' or ''name'' is required.**
**Parameter Details:**
- **code**: Exact 16-character EIC code (e.g., "21X000000001254A")
- **name**: Company name with fuzzy matching (e.g., "Stadtwerke", "RWE", "Netze BW")
- **country**: ISO 3166-1 alpha-2 code - Common: DE (Germany), FR (France), NL (Netherlands), AT (Austria), CH (Switzerland), PL (Poland), CZ (Czech Republic)
- **sector**: Filter by energy sector - "electricity" or "gas"
- **limit**: Results limit (1-100, default: 10)
**Use Cases:**
- Find valid operator codes for AGSI gas storage queries
- Research market partners and grid operators
- Validate EIC codes before API calls'
requestBody:
content:
application/json:
schema:
type: object
properties:
code:
type: string
description: Exact EIC code (16 characters, starts with 2 digits + X)
example: 21X000000001254A
pattern: ^[0-9]{2}X[A-Z0-9]{13}$
name:
type: string
description: Company/operator name (fuzzy search, minimum 3 characters recommended)
example: Stadtwerke München
minLength: 1
country:
type: string
description: ISO 3166-1 alpha-2 country code
example: DE
enum:
- AT
- BE
- BG
- CH
- CZ
- DE
- DK
- EE
- ES
- FI
- FR
- GB
- GR
- HR
- HU
- IE
- IT
- LT
- LU
- LV
- NL
- 'NO'
- PL
- PT
- RO
- SE
- SI
- SK
minLength: 2
maxLength: 2
sector:
type: string
enum:
- electricity
- gas
description: Energy sector filter
example: electricity
limit:
type: integer
description: Maximum number of results
minimum: 1
maximum: 100
default: 10
format:
type: string
enum:
- json
- csv
- xlsx
- xls
description: Output format. "csv" and "xls"/"xlsx" trigger a file download.
default: json
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
byExactCode:
summary: Find by exact EIC code
value:
code: 21X000000001254A
byCompanyName:
summary: Find by company name
value:
name: Stadtwerke München
country: DE
sector: electricity
limit: 10
byPartialName:
summary: Fuzzy search by partial name
value:
name: Netze
country: DE
limit: 20
gasOperatorsDE:
summary: Find German gas operators
value:
name: Gas
country: DE
sector: gas
limit: 15
csvExport:
summary: Export results as CSV
value:
name: Netze
country: DE
limit: 50
format: csv
/api/eic-codes/validate:
post:
summary: Validate EIC code format (IEC 62325 standard)
tags:
- EIC Code Management
operationId: eic_codes_validate
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: 'Validates EIC code format according to IEC 62325 standard. Checks: length (16 characters), LIO area (10-70), code type character, check digit algorithm. Use for pre-validation before API calls, form input validation.'
requestBody:
content:
application/json:
schema:
type: object
required:
- code
properties:
code:
type: string
minLength: 16
maxLength: 16
description: EIC code to validate
example: 21X000000001254A
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
validCode:
summary: Valid EIC code
value:
code: 21X000000001254A
invalidCode:
summary: Invalid EIC code
value:
code: INVALID123456789
/api/eic-codes/gas-operators:
get:
summary: List German gas storage operators with EIC codes
tags:
- EIC Code Management
operationId: eic_codes_gasOperators
parameters:
- name: country
in: query
schema:
type: string
default: DE
description: ISO country code
example: DE
- name: includeMetadata
in: query
schema:
type: boolean
default: false
description: Include additional operator details
example: false
- name: format
in: query
schema:
type: string
enum:
- json
- csv
- xlsx
- xls
default: json
description: Output format. "csv" and "xls"/"xlsx" trigger a file download.
example: json
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: List of gas storage operators with EIC codes
content:
application/json:
schema:
type: object
text/csv:
description: CSV download (when format=csv)
schema:
type: string
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
description: Excel XLSX download (when format=xlsx or format=xls)
schema:
type: string
format: binary
description: 'Retrieve list of gas storage system operators in Germany with their EIC codes. Use cases: Find valid codes for AGSI operator queries, German gas storage market overview, operator portfolio analysis.'
/api/eic-codes/gas-facilities:
get:
summary: List German gas storage facilities (UGS) with EIC codes
tags:
- EIC Code Management
operationId: eic_codes_gasFacilities
parameters:
- name: operatorCode
in: query
schema:
type: string
example: 21X000000001262B
description: Filter by operator EIC code
example: 21X000000001262B
- name: country
in: query
schema:
type: string
default: DE
description: ISO country code
example: DE
- name: format
in: query
schema:
type: string
enum:
- json
- csv
- xlsx
- xls
default: json
description: Output format. "csv" and "xls"/"xlsx" trigger a file download.
example: json
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: List of underground gas storage facilities with EIC codes
content:
application/json:
schema:
type: object
text/csv:
description: CSV download (when format=csv)
schema:
type: string
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
description: Excel XLSX download (when format=xlsx or format=xls)
schema:
type: string
format: binary
description: 'Retrieve underground gas storage facilities in Germany. Use cases: Find valid codes for AGSI facility queries, operator portfolio breakdown, facility-level monitoring.'
/api/eic-codes/statistics:
get:
summary: Statistics about EIC database (total count, breakdown by type/sector/country)
tags:
- EIC Code Management
operationId: eic_codes_statistics
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: Get comprehensive statistics about the EIC code database including 72,580+ total codes with breakdowns by type (party, resource, substation, area, operator, tie-line, location, facility), sector (electricity/gas), and country. Use for database health checks and coverage assessment.
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.'