Functional changes

• Added support for smart meter lookup using EAN (Electricity and Gas) codes
• Introduced new Smart Meter EAN-based lookup endpoints

Electricity EAN lookup

POST /api/v2/addresses/{address_uuid}/smart-meters/electricity/ean

• Finds the smart meter associated with a given electricity EAN at an address
• Request body:

{
  "ean": "871687940007565340"
}

Gas EAN lookup

POST /api/v2/addresses/{address_uuid}/smart-meters/gas/ean

• Finds the smart meter associated with a given gas EAN at an address
• Request body:

{
  "ean": "871687940007565340"
}

Purpose

Enables address-level resolution of smart meters using standardised EAN identifiers for electricity and gas connections.

This improves:

• Smart meter discovery and onboarding using external EAN identifiers
• Consistent mapping between addresses and metering infrastructure
• Support for integration flows where only EAN codes are available

Additional notes

• EAN format follows an 18-digit structure (8710xxxxxxxxxxxxxx)
• Electricity and gas EANs represent separate meter points within the same address context

Functional changes

• Introduced dedicated flex schedule endpoints (/flex/schedules) for group curtailment operations
• Added support for group-level curtailment controls using:
  • groupGridTargetKw
  • addressGridTargetW
  • solarInverterCapacityPercentage
• Mapped flex schedule fields to Amber group schedule fields:
  • group_grid_target_kw
  • grid_target_w
  • powerlimit
• Added inverter-level flex schedule views exposing resulting groupSolarInverterScheduleInterval data and steered watt targets
• Separated flex curtailment schedules from user/home inverter schedules (/schedules) to support distinct operational domains
• Retained user inverter schedules for home control use cases using:
  • powerlimit
  • zeroExport

Purpose

Provides a dedicated curtailment-oriented scheduling model for group operations while maintaining separate user-facing inverter scheduling functionality.

This enables:

• Grid-target-based curtailment operations for operators and flexibility services
• Read-only inverter-level visibility into executed group curtailment actions
• Clear separation between group curtailment logic and user/home inverter controls
• More scalable and future-proof scheduling APIs for curtailment and flexibility use cases

Additional notes

• addressGridTargetW is not equivalent to zeroExport; it represents a watt-based grid target used in curtailment operations
• solarInverterCapacityPercentage is analogous to powerlimit within the flex/group curtailment domain, but does not include the user scheduling concept of zeroExport

Retrieve aggregated solar production data in watt-hours (Wh) for a solar inverter.
GET /api/v2/addresses/{address_uuid}/solar-inverters/{solar_inverter_uuid}/interval/production

Description

Returns interval-based aggregation of:

• Production — Energy generated by the solar inverter (Wh)

Supported resolutions: quarter_hourly, hourly, daily, weekly, monthly, yearly

Required Query Parameters

• resolution
• fromDate (ISO 8601)
• toDate (ISO 8601)
• timezone

Retrieve aggregated electricity usage data (delivered and returned) in watt-hour (Wh) intervals for a specific smart meter. The aggregation is based on P1 data and supports multiple time resolutions via query parameters.

GET /api/v2/addresses/{address_uuid}/smart-meters/{smart_meter_uuid}/interval/electricity

GET /api/v2/addresses/{address_uuid}/smart-meters/{smart_meter_uuid}/interval/gas

Description

Returns aggregated electricity interval data for a smart meter, including:

• Delivery (energy consumed from the grid, in Wh)
• Return (energy fed back to the grid, in Wh)

Supported resolutions: quarter_hourly, hourly, daily, weekly, monthly, yearly

You can now retrieve live smart meter consumption and import/export data via our API.

This provides real-time insight into site-level electrical usage, helping with diagnostics, load management, and energy optimization.

What’s new?

• List Live Smart Meter Data – fetch instantaneous power, import/export values, and phase-level readings from a specific smart meter.

This helps users track consumption and grid interaction in real time, enabling more accurate reporting, alerting, and energy balancing.

Access control

This endpoint requires the correct API roles and permissions. If you receive a 401 (unauthorized) or 403 (forbidden) error, your account may not have the necessary access. Please contact your account administrator or support team for assistance.

You can now retrieve live EV charger session data via our API.

This enables real-time visibility into ongoing charging sessions, supporting faster diagnostics, session monitoring, and energy reporting.

What’s new?

• List Live Charger Session Data – fetch the current power output, energy delivered, and session status from a specific charger.

This allows users to monitor charging behavior in real time and integrate live charging metrics into dashboards, analytics tools, or energy management systems.

Access control

This endpoint requires the correct API roles and permissions. If you receive a 401 (unauthorized) or 403 (forbidden) error, your account may not have the necessary access. Please contact your account administrator or support team for assistance.

You can now retrieve live solar inverter production data via our API.

This provides real-time visibility into how each inverter at a site is performing, enabling faster diagnostics, performance monitoring, and energy reporting.

What’s new?

• List Live Production Data - fetch current solar energy production readings from a specific inverter.

This helps users monitor solar output in real time and integrate live production data into dashboards, analytics tools, or energy management systems.

Access control

This endpoint requires the correct API roles and permissions. If you receive a 401 (unauthorized) or 403 (forbidden) error, your account may not have the necessary access. Please contact your account administrator or support team for assistance.

You can now retrieve a list of all grid connections associated with a specific address via our API. This enables better visibility into how a site is connected to the wider energy grid, supporting planning, compliance, and operational use cases.

What’s new?

• List Grid Connections – fetch all grid connection records linked to a given address.

This helps users map and manage their physical energy infrastructure more effectively, especially in complex deployments involving multiple connection points.

Access control

This endpoint requires the appropriate API roles. If you receive a 401 (unauthorized) or 403 (forbidden) error, your account may not have access. Please contact support for assistance.

You can now retrieve detailed information about HVACs and batteries installed at a specific address via our API. This supports better insights into distributed energy assets and improves energy system planning and monitoring.

What's new?

• List HVACs - fetch all HVAC systems linked to an address.
• List Batteries - retrieve all associated battery based on an address.

This makes it easier to understand and manage on-site energy infrastructure - whether for asset tracking, system optimisation, or analytics.

Access control

These endpoints require appropriate API roles. If you encounter a 401 or 403 error, your account may not have the required permissions. Please contact support if needed.

From raw smart meter data to clear delivery/return forecasts

We’ve expanded our smart meter capabilities to include forecasting for both electricity delivered to and returned from the grid. These forecasts are particularly useful for planning energy usage, optimising self-consumption, or supporting dynamic tariff models.

What's new?

• Delivery forecasts estimate upcoming grid consumption for a given address and smart meter.
• Return forecasts estimate the expected feed-in to the grid, typically from sources like solar PV.

This provides a more complete picture of future grid interaction, helping systems anticipate and adapt energy behaviour more intelligently. These forecasts are generated using historical smart meter data combined with local weather and usage patterns.

Access control

As with other energy forecasting features, these endpoints require specific API roles. If you receive a 401 or 403, your account may not have access. Please contact support for assistance.