Data requirements

Data requirements

How much data each insight needs before it returns results. Available to signed-in developers.

Data requirements

How much data each insight needs before it returns results, and what else it depends on. Use it to plan your data feed and to explain empty results to your users.

Requirements per insight

InsightMinimum dataWorks best withAlso needsError when missing
Forecast, daily (up to 31 days ahead)7 days of energy data365 days––
Forecast, monthly (next 12 months)1 month of energy datanone stated––
Anomalies, daily30 days of daily data365 days or more––
Anomalies, monthly30 days of daily data and 6 months of monthly datanone stated––
Energy Usage Categories1 month of daily data12 months or more at hourly resolutionhouse_type for homes or a business type, and the questions tagged required_for_euc_to_workNOT_ENOUGH_DATA_POINTS and others
Similar HomesConsumption for the requested periodnone statedA home profile complete enough to match a group of similar homes; prices for cost comparisonsHOME_PROFILE_INSUFFICIENT_FOR_SIMILAR_HOMES and others
PV Disaggregation7 days of import and export data, hourly or betterImproves over timeSet up by Eliq per client–
Peak Power and Capacity Tariffs15, 30 or 60 minute data12 months (uses what exists if fewer)––
Energy Advisor1 month of datanone statedA location profile–
No-Meter (estimated daily)No meter datanone statedLocation profile fields per country, usually persons, heating_type_primary, house_type, hotwater_type–
BudgetsDaily resolution or betternone stated––
Monthly ReportThe previous month’s consumptionnone statedSent at the latest 10 days after month end–
Market PricesNonenone statedspot_price_region_id on the location, and a Nord Pool data licence–
Cost, for all insightsNonenone statedA price formula; otherwise an average price for the country is used–
Energy Insights for BusinessesAs for each insightnone statedLocation profile type set to Business–
Customer Map15, 30 or 60 minute electricity data: 12 months for the tariff picker, 3 months for asset detectionnone statedThe location exists in Eliq–

What each resolution unlocks

You sendUnlocks
Monthly dataMonthly forecast, monthly anomalies (with 30 days of daily data)
Daily dataDaily forecast, daily anomalies, Energy Usage Categories, Budgets, Energy Advisor
Hourly or betterPV Disaggregation (with import and export data), and the most accurate Energy Usage Categories
15, 30 or 60 minute dataPeak Power and Capacity Tariffs, Customer Map

If an insight returns an error instead of a result, the code tells you what is missing. See Errors.

Sign in to see data requirements

This page is part of the API reference and is available to signed-in developers.

Sign in Get access

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Updated on: 
Oct 17, 2026