---
title: "GET /state/{state}/renewables/current"
method: GET
path: "/state/{state}/renewables/current"
---

# GET /state/{state}/renewables/current

`GET /state/{state}/renewables/current`

Returns the current percentage of renewables in the grid

## Path parameters

- `state` string, required

## Query parameters

- `next` integer
- `previous` integer
- `resolution` 5 | 30

## Response `200`

The current percentage of renewables in the grid.

- union[]
  - union
    - ActualRenewable — Renewable data
      - `type` 'ActualRenewable', required
      - `duration` 5 | 15 | 30, required — Length of the interval in minutes.
      - `date` string, date, required — Date the interval belongs to (in NEM time). This may be different to the date component of nemTime, as the last interval of the day ends at 12:00 the following day. Formatted as a ISO 8601 date
      - `nemTime` string, date-time, required — The interval's NEM time. This represents the time at the end of the interval UTC+10. Formatted as a ISO 8601 time
      - `startTime` string, date-time, required — Start time of the interval in UTC. Formatted as a ISO 8601 time
      - `endTime` string, date-time, required — End time of the interval in UTC. Formatted as a ISO 8601 time
      - `renewables` number, required — Percentage of renewables in the grid
      - `descriptor` 'best' | 'great' | 'ok' | 'notGreat' | 'worst', required — Describes the state of renewables. Gives you an indication of how green power is right now
    - CurrentRenewable — Returns the current interval's renewables
      - `type` 'CurrentRenewable', required
      - `duration` 5 | 15 | 30, required — Length of the interval in minutes.
      - `date` string, date, required — Date the interval belongs to (in NEM time). This may be different to the date component of nemTime, as the last interval of the day ends at 12:00 the following day. Formatted as a ISO 8601 date
      - `nemTime` string, date-time, required — The interval's NEM time. This represents the time at the end of the interval UTC+10. Formatted as a ISO 8601 time
      - `startTime` string, date-time, required — Start time of the interval in UTC. Formatted as a ISO 8601 time
      - `endTime` string, date-time, required — End time of the interval in UTC. Formatted as a ISO 8601 time
      - `renewables` number, required — Percentage of renewables in the grid
      - `descriptor` 'best' | 'great' | 'ok' | 'notGreat' | 'worst', required — Describes the state of renewables. Gives you an indication of how green power is right now
    - ForecastRenewable — Returns a forecasted renewables based on AEMO modelling. This is what AEMO thinks the renewables will be during the interval.
      - `type` 'ForecastRenewable', required
      - `duration` 5 | 15 | 30, required — Length of the interval in minutes.
      - `date` string, date, required — Date the interval belongs to (in NEM time). This may be different to the date component of nemTime, as the last interval of the day ends at 12:00 the following day. Formatted as a ISO 8601 date
      - `nemTime` string, date-time, required — The interval's NEM time. This represents the time at the end of the interval UTC+10. Formatted as a ISO 8601 time
      - `startTime` string, date-time, required — Start time of the interval in UTC. Formatted as a ISO 8601 time
      - `endTime` string, date-time, required — End time of the interval in UTC. Formatted as a ISO 8601 time
      - `renewables` number, required — Percentage of renewables in the grid
      - `descriptor` 'best' | 'great' | 'ok' | 'notGreat' | 'worst', required — Describes the state of renewables. Gives you an indication of how green power is right now

## Other responses

- `400` — Bad request
- `404` — State not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/amberelectric/apis/amber-electric-public-api.md) · [All operations](https://skmtc.net/amberelectric/apis/amber-electric-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/amberelectric/amber-electric-public-api/versions/1f80cddf9ed6/schema)