---
title: "Search Cernion energy objects (companies, VDMI, ZNP, grid connections, EDM)"
method: GET
path: "/api/query/search"
tags: ["Query Tools", "Copilot"]
---

# Search Cernion energy objects (companies, VDMI, ZNP, grid connections, EDM)

`GET /api/query/search`

## Request

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

Search across Cernion energy management data for use in Microsoft 365 Copilot, OpenAPI plugins, and connected integrations.

**Supported domains**:
- **companies** — Search company entities (Stadtwerke, Konzernverbund) by name. Returns BDEW codes, market roles, member count.
- **vnb** — Narrow search to companies with a Verteilnetzbetreiber (VNB) market role.
- **edm** — Look up a Messlokalisation (MeLo) by its exact DE-prefixed ID.
- **vdmi** — Search VDMI responsibility matrix instances by name, scope, or process type.
- **grid_connection** — Search past grid connection validation reports by operator name or decision.
- **znp** — Search Zielnetzplanung projects by name.
- **all** (default) — Searches all domains in parallel.

Each result carries **domain**, **type**, **id**, **title**, **excerpt**, **status**, and **url** pointing to the detail endpoint for that object.

**Performance**: Deterministic, < 300 ms. Does not invoke any external API or LLM.

**For complex natural-language queries** (e.g. "PV-Kapazität in Bayern") use POST /ask instead.

## Query parameters

- `q` string, required
- `domain` 'companies' | 'vnb' | 'edm' | 'vdmi' | 'grid_connection' | 'znp' | 'all'
- `limit` integer
- `token` string

## Response `200`

Search results from matched domains

- object
  - `query` string, required: The original search term
  - `domain` 'companies' | 'vnb' | 'edm' | 'vdmi' | 'grid_connection' | 'znp' | 'all', required
  - `totalResults` integer, required
  - `results` object[], required
    - `id` string, required: Unique identifier within the domain
    - `title` string, required: Primary display name
    - `excerpt` string, required: One-line context string with key attributes
    - `domain` 'companies' | 'edm' | 'vdmi' | 'grid_connection' | 'znp', required: Source domain of this result
    - `type` string, required: Object type within the domain
    - `status` string, nullable, required: Lifecycle or decision status of the object
    - `url` string, required: API path to retrieve the full record
    - `metadata` object: Domain-specific structured attributes

## Other responses

- `400`: Validation error — q is missing or too long, limit out of range

---

[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)