How to access our downloadable datasets
About our datasets
Our datasets cover a wide range of New Zealand electricity industry data and are available to download. Key features include:
- Detailed descriptions - each dataset is described in detail to help you understand the data and how to use it
- Structured folders - some datasets include subfolders with additional files or supporting information
- Easy downloads - files can be downloaded by clicking on them in your web browser - no special tools required.
Options for automated access
There are three methods for accessing our datasets by interacting directly with the underlying data storage as described below.
Azure Blob Storage is the storage technology used. You can access the datasets directly from blob storage to efficiently and automatically download multiple files at once to your own system.
For any questions or support, please contact info@ea.govt.nz
1. Azure Storage Explorer - download folders or lots of files
This method is best if you want to interactively download many files or download entire folders of files.
Download and install the Microsoft Azure Storage Explorer tool; instructions and download links are available at: https://azure.microsoft.com/en-us/products/storage/storage-explorer
In the Azure Storage Explorer application:
- select the Open Connect Dialog button
- Select Blob container or directory
- Select Shared access signature URL (SAS) and click Next
- Copy and paste this string into the Blob container or directory SAS URL area and click Next followed by Connect: https://emidatasets.blob.core.windows.net/publicdata?sv=2021-10-04&si=publicdata&sr=c&sig=f034UWz1xmMbk89jd76zY0M%2BwycFDhhumejUrjqlfIw%3D
You will be able to browse the datasets storage and its contents.
2. Command line access - create simple scripted processes
This method is ideal for creating simple scripted processes.
Download and install the AzCopy tool; instructions and download links are available at: https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-v10
Use the second half of the aforementioned SAS URL in AzCopy commands: ?sv=2021-10-04&si=publicdata&sr=c&sig=f034UWz1xmMbk89jd76zY0M%2BwycFDhhumejUrjqlfIw%3D
Two AzCopy commands are explained:
- Download a file
Syntax: azcopy.exe copy <source location> <target location>
Example: azcopy.exe copy "https://emidatasets.blob.core.windows.net/publicdata/Datasets/Wholesale/MappingsAndGeospatial/NetworkSupplyPointsTable/20230404_NetworkSupplyPointsTable.csv??sv=2021-10-04&si=publicdata&sr=c&sig=f034UWz1xmMbk89jd76zY0M%2BwycFDhhumejUrjqlfIw%3D" "C:\Temp"
- List files
Syntax: azcopy.exe list <source location>
Example: azcopy.exe list
https://emidatasets.blob.core.windows.net/publicdata/Datasets/Wholesale/MappingsAndGeospatial/NetworkSupplyPointsTable/??sv=2021-10-04&si=publicdata&sr=c&sig=f034UWz1xmMbk89jd76zY0M%2BwycFDhhumejUrjqlfIw%3D
See the AzCopy documentation for directing a list to a file rather than the screen.
3. Programmatic access - download lots of files
This method is best if you want to automatically download large numbers of files into your own system.
The blob storage endpoint to use is the same as in the Azure Storage Explorer directions above, or you can directly access the storage container at: https://emidatasets.blob.core.windows.net/publicdata?restype=container&comp=list
We provide three examples of programmatically accessing datasets:
- Example 1: Access more list information - Each list request will contain a maximum of 5,000 blobs. If there are more than 5,000 blobs a marker value is included in the NextMarker element at the end of the XML response. To return the next set of results, pass the value returned in the NextMarker tag as the marker parameter in the request URL:
https://emidatasets.blob.core.windows.net/publicdata?restype=container&comp=list&marker=2!144!MDAwMDY0IURhdGFzZXRzL1dob2xlc2FsZS9CaWRzQW5kT2ZmZXJzL09mZmVycy8yMDE2LzIwMTYxMjEwX09mZmVycy5jc3YhMDAwMDI4ITk5OTktMTItMzFUMjM6NTk6NTkuOTk5OTk5OVoh
- Example 2: Access to a folder - Alternatively, you can narrow your search to a specific folder by using the prefix parameter in the request URL:
https://emidatasets.blob.core.windows.net/publicdata?restype=container&comp=list&prefix=Datasets/Wholesale/BidsAndOffers/Bids/2025
- Example 3: Access to a file
https://emidatasets.blob.core.windows.net/publicdata/Datasets/Wholesale/BidsAndOffers/Bids/2025/20250101_Bids.csv
Here is some reference information:
Datasets
Access the original data files used in our data charts and dashboards.