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

# Machine-readable catalog of all v2 endpoints

`GET /v2`

## Request

- Base URL: `https://api.energy-charts.info` (the document declares no server; this is the origin it was published from)
- URL: `https://api.energy-charts.info/v2`
- Auth: none declared
- TypeScript: <https://skmtc.dev/energy-charts/apis/energy-charts-api/docs/v2/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Changes

- **2026-08-04** `ebf9e22a0925`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/energy-charts/apis/energy-charts-api/changes/v2/get.md)

---

[API](https://skmtc.dev/energy-charts/apis/energy-charts-api.md) - [All operations](https://skmtc.dev/energy-charts/apis/energy-charts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/energy-charts/apis/energy-charts-api/revisions/523d3ec0fd82?raw)