API Docs


Learn how to integrate a Meter portfolio with your existing system.

Meters are the basic units of inventory providing grid services. Your Meters represent the end customers and devices that will enroll in programs, respond to dispatches, unlock revenue, and aid grid reliability.

Manage a Meter Portfolio

The steps below explain how Meters are structured, and the steps to maintain an updated inventory of meters.

Track new Meter Authorizations

Meters are created following a successful end-customer authorization. Each new meter receives a unique meter_id, which is used to identify objects in Bidding and Dispatching.

If specified on the Registration Link, new meters are tagged with a partner_reference identifier. Use the partner_reference to create a relationship with assets in your internal inventory.

The meter object contains a few categories of metadata:

  • Grid Data: grid operator (ISO/RTO) and zone of the grid
  • Utility: distribution utility serving the meter and the utility's site identifier
  • Location: customer and address information

Monitor Market Enrollment

In some markets, meters must be enrolled and approved prior to participation. The enrollment object provides information on the meter's status in the market.

"enrollment": {
"status": "Active",
"active_from": "2021-05-19T07:00:00Z",
"active_to": "2021-12-31T08:00:00Z",
"eligible_from": "2021-05-19T07:00:00Z",
"eligible_to": "2029-01-02T08:00:00Z",
"status_reasons": []

Sync Participation Details

When participating in the market, meters are aggregated into groups. If you have an internal system that manages your assets at an aggregated level, it may be important to sync your inventory against Leap's group assignment.

Grouping is denoted using market_group_id in the participation array. Group assignment information can change over time. The participation array provides assignment for the current and upcoming 2 days.

"participation": [
"market_group_id": "959b2bfb-ec22-4fdf-be54-173639c4e925",
"trade_date": "2021-06-02T07:00:00Z"
"market_group_id": "959b2bfb-ec22-4fdf-be54-173639c4e925",
"trade_date": "2021-06-03T07:00:00Z"
"market_group_id": "959b2bfb-ec22-4fdf-be54-173639c4e925",
"trade_date": "2021-06-04T07:00:00Z"

Note: If you are using group dispatches, it is essential that you keep your inventory in sync. Dispatching a group with outdated assignment can cause poor performance and lost revenue.