Areas

Get Area

Get metadata for one canonical area.

get/v1/areas/{area_id}

Request

  • Base URL: https://grid.rebase.energy/api
  • URL: https://grid.rebase.energy/api/v1/areas/{area_id}
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-API-Key

Path parameters

area_idstring required

Response

Successful Response

area_idstring required

Canonical area identifier. Country areas use ISO 3166-1 alpha-2 codes (e.g. DE); bidding/control areas keep the existing zone keys (e.g. DK-DK1, US-NY-NYIS).

area_type'country' | 'bidding_zone' | 'control_area' | 'synchronous_area' | 'market_coupling_area' | 'region' required

Semantic area type.

namestring required

Human-readable area name.

country_codestring nullable

ISO 3166-1 alpha-2 country code when the area belongs to one country.

timezonestring nullable

IANA timezone identifier for zone-derived areas.

codesobject

Additional stable identifiers. Country areas may include iso_alpha3; ENTSO-E areas may include entsoe_eic and entsoe_capacity_eic.

relationshipsobject

Area relationships such as country, synchronous_area, region, market_coupling_area, or contains.

sourcesobject

Available data sources and their data types for zone-derived areas.

source_datatypesobject nullable

Per data type/source collection semantics, when annotated.

Changes

No recorded changes to this operation across all 1 revision of this API.