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

# Get energy comparison

`GET /houses/{houseId}/energy-comparison`

## Request

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

Returns the energy of a house for a month and a comparison with different profiles

## Path parameters

- `houseId` string, required

## Query parameters

- `month` string, required

## Response `200`

User house profile

- EnergyComparison
  - `consumption` number, float: Energy consumption of the house
  - `currentYear` boolean, required: If the comparison is for the current year
  - `profile` 'EFFICIENT,' | 'MEDIUM,' | 'INEFFICIENT' | 'NO_PROFILE', required: Current profile of the house
  - `similarHomesConsumption` number, float: Average consumption of similar homes. Can be null (depends on configuration)
  - `energyEfficientHomesConsumption` number, float: Average consumption of energy efficient homes. Can be null (depends on configuration)
  - `neighborhoodHomesConsumption` number, float: Average consumption of homes in the neighborhood

## 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)