Skip to main content
Docs / Public API Reference
Docs Menu

Public API Reference

The free public API serves the generation and renewable project register and 5-minute unit output. No key is needed.

This is Network Map's free public API only. It is separate from the Network Map platform and Enterprise APIs, which are private, require an account and are not publicly documented.

Endpoints

Enterprise API Access page describing Esri ArcGIS compatibility and the REST API
API Access in the sidebar User Menu opens the Enterprise API Access page. Choose Schedule Enterprise Consultation to ask for Enterprise API access.
RequestReturnsParameters
GET https://renewables.networkmap.energy/api/geojsonEvery generation and renewable project as a GeoJSON FeatureCollectionnone
GET https://renewables.networkmap.energy/api/geojson?region=VIC1The same, filtered to one market regionregion: NSW1, QLD1, SA1, TAS1 or VIC1
GET https://renewables.networkmap.energy/api/geojson?listDUIDsEvery unit ID with its site namenone
GET https://renewables.networkmap.energy/api/generation?duid=ARWF15-minute output as [timestamp_ms, MW] pairsduid (required); start, end in epoch milliseconds (default: the last 7 days)

Project Fields

Each project feature includes, among others: Site Name, Owner, Region, Technology Type, Fuel Type, Nameplate Capacity (MW), Storage Capacity (MWh), Unit Status, DUID (the unit ID), Full Commercial Use Date, Expected Closure Year, DNSP and TNSP with the nearest lines and distances, LGA, Postcode and the AEMO KCI Id. Most values are strings. Missing values are NaN, empty or null. Coordinates is an object with lat and lng.

TermMeaning
DUIDDispatchable unit identifier: the market code for a generating or load unit. These pages call it the unit ID.
DNSPDistribution network service provider
TNSPTransmission network service provider
LGALocal government area
KCIKey Connection Information: published connection details for a generating or load unit

See the Glossary for more terms.

Examples

curl "https://renewables.networkmap.energy/api/geojson?region=VIC1" curl "https://renewables.networkmap.energy/api/generation?duid=ARWF1"

Example Responses

These are trimmed responses from the public API. ... shows where we removed fields or items. Field names are exact.

Project register: geojson and geojson?region=

Both requests return the same shape. /api/geojson returns every project. /api/geojson?region=TAS1 returns only TAS1 projects. This is one TAS1 feature:

{"type":"FeatureCollection","crs":{"type":"name","properties":{"name":"urn:ogc:def:crs:OGC:1.3:CRS84"}},"features":[ {"type":"Feature","properties":{"Region":"TAS1","Asset Type":"Existing Plant","Site Name":"Bastyan", "Owner":"Hydro-Electric Corporation","Technology Type":"Hydro - Dam","Fuel Type":"Hydro - Water", "DUID":"BASTYAN","Nameplate Capacity (MW)":"79.9","Storage Capacity (MWh)":"NaN","Unit Status":"In Service", "AEMO KCI Id":"NaN","Coordinates":{"lat":-41.73616837872272,"lng":145.53218544705183}, "LGA":"West Coast (M)","Postcode":"7321","TNSP":"","DNSP":"TasNetworks", "DNSP Line 1":"110kV Lines - Queenstown to Farrell","DNSP Distance 1":"16.61091103768019", ...}, "geometry":{"type":"Point","coordinates":[145.53218544705183,-41.73616837872272]}}, ... ]}

Unit list: geojson?listDUIDs

Each item has a DUID and a Site Name. Projects with no DUID show "NaN".

[{"DUID":"NaN","Site Name":"133 Castlereagh St"}, {"DUID":"ADPBA1G","Site Name":"Adelaide Desalination Plant"}, ...]

Unit output: generation?duid=

A 15-minute window for ARWF1. Each pair is [timestamp_ms, MW] for one 5-minute interval of AEMO-published data. Some intervals can be missing from the list, as in this example.

curl "https://renewables.networkmap.energy/api/generation?duid=ARWF1&start=1794451200000&end=1794452100000" [[1794451200000,107.2],[1794451800000,112.1],[1794452100000,112.8]]

Errors and Empty Results

The API does not always return an error code. Check the HTTP status, and check that the body is valid JSON before you use it.

RequestWhat you get
generation with no duidHTTP 500 with an empty body
generation with an unknown duid, for example NOTAUNIT9HTTP 500 with an empty body
generation with a duid in lower case, for example arwf1HTTP 500 with an empty body. Use the DUID exactly as listDUIDs shows it.
start or end that is not a numberHTTP 200 with a text message, for example Invalid start parameter: abc. The body is not JSON.
start later than endHTTP 200 with an empty list: []
region that is unknown or in lower case, for example XYZ1 or tas1HTTP 200 with an empty FeatureCollection: "features":[]

Limits

The API needs no key. No rate limit is published. The full project list is a large file, so filter by region when you can. For unit output, set start and end to the window you need. If you leave them out, you get the last 7 days. Use the API fairly. For heavy or regular automated use, email support@networkmap.energy.

Data Sources and Terms

The project register blends several public sources, including AEMO generation reports. Unit output is AEMO-published 5-minute data. Use the data for screening, planning and analysis. Check it with the relevant network service provider before detailed design. The Network Map Terms of Use and Disclaimer and Terms & Conditions apply.

See the Integrations guide to load the API into QGIS, Power BI or Excel.

Related Guides

Can't find what you need? Email support@networkmap.energy or call 1300 936 116. Sign in to Network Map.