---
title: "Natural language query to energy data (MaStR, ENTSO-E, SMARD)"
method: POST
path: "/api/query/ask"
tags: ["Query Tools"]
---

# Natural language query to energy data (MaStR, ENTSO-E, SMARD)

`POST /api/query/ask`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/query/ask`
- Auth: none declared

Execute natural language queries against German energy data sources including MaStR (Marktstammdatenregister), ENTSO-E Transparency Platform, and SMARD.de. Supports multi-source data aggregation and complex queries without SQL knowledge.

**Data Sources**:
- **MaStR**: German registry of all energy installations (PV, wind, storage, etc.)
- **ENTSO-E**: European electricity grid transparency data
- **SMARD**: German electricity market data

**Use Cases**:
- Ad-hoc data exploration ("How much PV capacity in Bavaria?")
- Quick questions without SQL knowledge
- Multi-source data aggregation
- Portfolio analysis and market research

**Response Time**: Typically 2-8 seconds (includes LLM reasoning)

## Query parameters

- `token` string

## Request body

- object
  - `query` string, required: Natural language question in German or English
  - `explain` boolean: Include detailed reasoning and data sources used
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Successful query execution with answer and metadata

- object
  - `success` boolean
  - `answer` string: Natural language answer
  - `data` object: Structured data result
  - `sources` string[]: Data sources used
  - `reasoning` unknown[]: Query reasoning steps (if explain=true)
    - unknown
  - `metadata` object: Execution metadata

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)