Reference · built on requestCommons signalEnergy & grid

Electricity Authority EMI API

New Zealand dispatch prices and load per point of connection, plus ICP connection records, with a subscription key.

Request accessPricing ↗

About

EMI is the Electricity Authority of New Zealand's market information site. Its developer portal on Azure API Management exposes two products. Wholesale market prices carries the Real-time dispatch API: a GET that returns, per point of connection, the latest five-minute dispatch price in dollars per megawatt-hour with dispatched load and generation megawatts, filterable with OData. ICP connection data carries the ICP connection data v2 API: search by address, or fetch one Installation Control Point with its address, network, pricing category, trader and metering detail.

An operator watches the dispatch price at your point of connection and proposes when to shed or shift load. You approve; the receipt keeps the interval and the price.

This is a reference listing. It documents what Fibric would read from Electricity Authority EMI API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Real-time dispatch: DollarsPerMegawattHour, SPDLoadMegawatt and SPDGenerationMegawatt per PointOfConnectionCode for the latest five-minute interval
  • FiveMinuteIntervalDatetime, FiveMinuteIntervalNumber and RunDateTime on every dispatch row, filterable with OData $filter
  • ICP connection data v2, get by id: Address, Network, Pricing, Trader and Metering blocks for one 15-character ICP
  • ICP connection data v2, search: matching ICPs found through address filters
  • Metering detail per ICP: installation category, certification expiry, component serials, channels and AMIFlag

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Shed on a five-minute dispatch price

    Call Real-time dispatch with $filter=PointOfConnectionCode eq your code. When DollarsPerMegawattHour crosses your threshold, the operator proposes the loads to shed for the coming intervals and records the run it read.

    With Price Shift, Peak Demand

  • Check a site's ICP before a rate review

    Fetch the ICP by id. The operator reads DistributorPriceCategoryCode, ProfileCode and the metering installation detail, then proposes whether a rate change request is worth raising with the trader.

    With Rate Switch

  • Hold a battery through an expensive evening

    Track DollarsPerMegawattHour and SPDLoadMegawatt at your point of connection across the evening intervals. The operator proposes a discharge window and a charge window after the price falls, for your approval.

    With Battery Dispatch

Requirements

  • An EMI API community account and a subscription to the Wholesale market prices or ICP connection data product, approved by the API administrator
  • The subscription key on every call
  • OData filter syntax for PointOfConnectionCode, FiveMinuteIntervalNumber and DollarsPerMegawattHour
  • A valid 15-character ICP (10 digits, 2 characters, 3 hexadecimal characters) for get-by-id
Authentication
A subscription key. You sign up on the developer portal, subscribe to an API product, and use the key once the API administrator approves the subscription.

Limits

  • Wholesale price APIs: 60 calls per minute and 60 MB of data per hour under the portal policy; the Authority may revise it
  • Real-time dispatch returns the latest run only; this API does not serve price history
  • Three APIs in the product (Forecast NRSS prices, Forecast PRSS prices, Real-time prices) were decommissioned on 21 October 2022; WITS carries those prices
  • RunDateTime is UTC without a marker while FiveMinuteIntervalDatetime is NZ local time; a client must convert

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request Electricity Authority EMI API ↗

Questions and answers

How do I get a key, and does it cost anything?
Sign up as a member of the API community on the developer portal, then subscribe to a product. The API administrator is invited to approve the request, and approval is required before the API can be used. The portal lists no price for either product.
What does the Real-time dispatch API return?
A JSON list of the latest dispatch variables per point of connection: PointOfConnectionCode, FiveMinuteIntervalDatetime, FiveMinuteIntervalNumber, RunDateTime, SPDLoadMegawatt, SPDGenerationMegawatt and DollarsPerMegawattHour. Dispatch prices are similar to but not identical to real-time prices, which are generated a few minutes apart.
What are the usage limits?
The portal applies a policy to the wholesale price APIs of 60 calls per minute and a total of 60 MB of data per hour, which the Authority may revise if high utilisation affects performance. The ICP connection data policy is set in that API product.
Ask about Electricity Authority EMI API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by Electricity Authority (New Zealand) (emi.azure-api.net). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy