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

# Traffic Signal

`GET /signal`

<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

---

[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/versions/ebf9e22a0925/schema)