---
title: "Get house energy"
method: GET
path: "/houses/{houseId}/energy"
tags: ["Energy"]
---

# Get house energy

`GET /houses/{houseId}/energy`

## Request

- Base URL: `https://connect.clever.gy`
- URL: `https://connect.clever.gy/houses/{houseId}/energy`
- Auth: API key in header `clevergy-api-key`

Returns the energy of a house for a date period (from startDate to endDate)
grouped by date based on granularity

## Path parameters

- `houseId` string, required

## Query parameters

- `startDate` string, date-time, required
- `endDate` string, date-time, required
- `granularity` 'YEARLY' | 'MONTHLY' | 'DAILY' | 'HOURLY', required
- `includeTimeSpanStart` string
- `includeTimeSpanEnd` string
- `timeZone` string

## Response `200`

House consumption

- EnergyItem[]
  - `date` string, date-time, required
  - `solar` object
    - `production` number, float
    - `gridImport` number, float, nullable
    - `gridExport` number, float, nullable
  - `house` object
    - `consumption` number, float
    - `selfConsumption` number, float
  - `grid` object
    - `import` number, float
    - `export` number, float
  - `battery` object
    - `charge` number, float
    - `discharge` number, float
  - `energyCommunities` object[]
    - `type` 'SOLAR' | 'WIND' | 'HYDRO', required
    - `production` number, float, required
  - `smartDevices` object[]
    - `subtype` string, required
    - `vendor` 'SHELLY', required
    - `energy` number, float, required

## Other responses

- `401`: Unauthorized
- `404`: Not found
- `default`: Unexpected error

---

[API](https://skmtc.dev/clevergy/apis/clevergy-connect-api.md) - [All operations](https://skmtc.dev/clevergy/apis/clevergy-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clevergy/apis/clevergy-connect-api/revisions/d333c5eecb5b?raw)