---
title: "Grid frequency (RG Continental Europe), 1 second resolution"
method: GET
path: "/v2/frequency"
tags: ["power v2"]
---

# Grid frequency (RG Continental Europe), 1 second resolution

`GET /v2/frequency`

## 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/frequency`
- Auth: none declared
- TypeScript: <https://skmtc.dev/energy-charts/apis/energy-charts-api/docs/v2/frequency/get.ts> (a function with typed inputs; its response is checked against the schema)

Grid frequency in hertz (Hz) measured at Fraunhofer ISE in Freiburg, Germany (RG Continental Europe). Available in 1 second steps from 2022-05-01 on; the requested interval is limited to 3 days. Timestamps are ISO 8601 in UTC.

## Query parameters

- `region` string: Measurement region (currently only 'DE-Freiburg')
- `start` string: Accepted formats: ISO 8601 (`2026-01-01T17:00Z`), day (`2026-01-01`, interpreted in the local timezone) or unix seconds (`1767222000`). Empty start defaults to today; empty end defaults to start.
- `end` string: Accepted formats: ISO 8601 (`2026-01-01T17:00Z`), day (`2026-01-01`, interpreted in the local timezone) or unix seconds (`1767222000`). Empty start defaults to today; empty end defaults to start.

## Response `200`

Successful Response

- TimeSeriesResponseV2: Uniform, self-describing time-series envelope of all v2 endpoints.
  - `schema_version` string, required: Version of this response schema.
  - `endpoint` string, required: Name of the endpoint that produced this response.
  - `country` string, nullable: Country code the data refers to (lowercase), if applicable.
  - `bidding_zone` string, nullable: Bidding zone the data refers to, if applicable.
  - `timezone` string, required: IANA timezone in which all timestamps of this response are expressed.
  - `resolution` string, nullable: Temporal resolution as ISO 8601 duration (e.g. PT15M, PT1H, P1D, P1M, P1Y). `null` if the time axis is irregular.
  - `interval_minutes` integer, nullable: Temporal resolution in minutes. `null` if irregular or if the step is calendar based (months / years).
  - `unit` string, nullable: Default unit of all series. Individual series may override it via `series[*].unit`.
  - `generated_at` string, required: ISO 8601 time at which this response body was generated. Responses may be served from a short-lived cache; this field always reflects the true generation time.
  - `available_from` string, nullable: Timestamp of the first record that contains at least one non-null value. `null` if the response is empty.
  - `available_until` string, nullable: Timestamp of the last record that contains at least one non-null value (data availability at generation time). `null` if the response is empty.
  - `series` SeriesDescriptorV2[], required: Descriptors of all series present in `data[*].values`.
    - `id` string, required: Stable snake_case identifier. Key of this series inside every `data[*].values` object.
    - `name` string, required: Human readable display name of the series.
    - `unit` string, nullable: Unit of this series if it differs from the envelope-level `unit`. Omitted when the envelope-level unit applies.
    - `description` string, nullable: Free-text explanation of the series semantics. Omitted when there is nothing to explain beyond the name.
  - `data` DataPointV2[], required: Chronologically ordered records.
    - `timestamp` string, required: ISO 8601 timestamp with UTC offset, expressed in the envelope `timezone`. Marks the START of the period the values refer to. Single exception: `installed_power`, where the timestamp labels the reporting year or month and values represent the state at the END of that period (or the net change during it, with installation_decommission=true).
    - `values` object, required: Mapping of series id -> value. `null` means the value is not (yet) available for this timestamp.
  - `attributes` object: Endpoint specific metadata (e.g. forecast_type).
  - `license` string, nullable: License of the data in this response.
  - `deprecated` boolean, required: True if this endpoint is scheduled for discontinuation.

## Other responses

- `400`: Invalid parameters
- `404`: No data available
- `422`: Validation Error

## Changes

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

[Operation history](https://skmtc.dev/energy-charts/apis/energy-charts-api/changes/v2/frequency/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)