---
title: "Machine-readable catalog of all v2 endpoints"
method: GET
path: "/v2"
tags: ["v2"]
---

# Machine-readable catalog of all v2 endpoints

`GET /v2`

Self-describing directory of the v2 API.

Lists every v2 endpoint with its parameters, accepted values and
defaults, derived from the live OpenAPI schema. Intended as the single
entry point for AI agents and other automated clients.

## Response `200`

Successful Response

- CatalogResponseV2 — Self-describing directory of the v2 API, returned by ``GET /v2``.
  - `schema_version` string, required — Version of the v2 response schema.
  - `title` string, required — API title.
  - `description` string, required — What this API provides and how to read responses.
  - `openapi_url` string, required — Path of the full OpenAPI 3 schema.
  - `response_envelope` string, required — Name of the uniform response model every data endpoint returns.
  - `endpoints` CatalogEntryV2[], required — All available v2 endpoints.
    - `path` string, required — Absolute request path.
    - `method` string, required — HTTP method.
    - `summary` string, nullable — One-line summary.
    - `description` string, nullable — Full description.
    - `tag` string, nullable — OpenAPI tag group.
    - `parameters` ParameterDescriptorV2[], required — Query parameters accepted by this endpoint.
      - `name` string, required — Query parameter name.
      - `type` string, required — JSON type of the parameter (string, integer, boolean).
      - `required` boolean, required — Whether the parameter must be provided.
      - `default` string, nullable — Default value used when the parameter is omitted.
      - `allowed_values` string[], nullable — Closed list of accepted values, if the parameter is an enum.
      - `description` string, nullable — Free-text explanation of the parameter.

---

[API](https://skmtc.net/energy-charts/apis/energy-charts-api.md) · [All operations](https://skmtc.net/energy-charts/apis/energy-charts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/energy-charts/energy-charts-api/revisions/ebf9e22a0925/schema)