---
title: "Traffic Signal"
method: GET
path: "/signal"
tags: ["ren_share"]
---

# Traffic Signal

`GET /signal`

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

<b>Electricity traffic signal</b>
    


    

Returns the renewable share of load in percent from today until prediction is currently available and the corresponding traffic light.
    


    

The traffic light "signal" is indicated by the following numbers:
    


    -1: Red (grid congestion),
    0: Red (low renewable share),
    1: Yellow (average renewable share),
    2: Green (high renewable share)
    


    

If no data is available from the primary data providers, a best guess is made from historic data. This is indicated by "substitute" set to True.
    


    

"postal_code" is an optional input parameter, which will consider the local grid state (e.g. transmission line overload) in future implementations.
    


    

Response schema:
    

```json
{
    "unix_seconds": [int],
    "share": [float],
    "signal": [int],
    "substitute": bool,
    "deprecated": bool
}
```

## Query parameters

- `country` string
- `postal_code` string

## Response `200`

Successful Response

- TrafficModel
  - `unix_seconds` integer[], required
  - `share` number[], required
  - `signal` integer[]: 0: Red (low renewable share) 1: Yellow (average renewable share) 2: Green (high renewable share)
  - `substitute` boolean, required
  - `deprecated` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2025-05-06** `63bae0186e06`: 2 breaking, 1 info
  - response property `share/items/` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `signal/items/` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the required property `deprecated` to the response with the `200` status

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