---
title: "Load VDMI matrix context (read-only)"
method: GET
path: "/api/copilot-process/vdmi/:matrixId/context"
tags: ["Copilot Process"]
---

# Load VDMI matrix context (read-only)

`GET /api/copilot-process/vdmi/:matrixId/context`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/copilot-process/vdmi/:matrixId/context`
- Auth: none declared

Returns full VDMI matrix context for Copilot: status, open tasks, nomination state, evidence count, and regulatory basis.

**When to use**: Before proposing any VDMI process action, load context to understand current state.
**Read-only**: No state is changed.

## Path parameters

- `matrixId` string, required

## Query parameters

- `token` string

## Response `200`

VDMI matrix context

- object
  - `matrixId` string, required
  - `name` string, required
  - `status` string, required
  - `processType` string, nullable
  - `nominationStatus` string, nullable
  - `openTaskCount` integer, required
  - `totalTaskCount` integer
  - `evidenceCount` integer
  - `findingCount` integer
  - `scope` string, nullable
  - `regulatoryBasis` string[]
  - `createdAt` string, nullable
  - `summary` string, required: Human-readable status summary
  - `detailUrl` string

## Other responses

- `404`: Matrix not found

---

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