---
title: "Retrieve Consumption Profile"
method: GET
path: "/tenants/{tenant_id}/projects/{id}/consumption_profile"
tags: ["Consumption Profiles"]
---

# Retrieve Consumption Profile

`GET /tenants/{tenant_id}/projects/{id}/consumption_profile`

Retrieve the consumption profile for a project.

## Path parameters

- `tenant_id` string, uuid, required
- `id` string, uuid, required

## Response `200`

Consumption Profile successfully retrieved.

- object
  - `consumption_profile` object
    - `id` string, uuid — Unique ID identifying the consumption profile.
    - `project_id` string, uuid — Unique ID identifying the project that the consumption profile belongs to.
    - `location` string — Name of a nearby weather station that was used as the source of weather data.
    - `utility` string — Name of the utility company that the homeowner is connected to before going solar.
    - `utility_id` string, uuid — Unique ID of the utility company that the homeowner is connected to. Field is omitted if utility rate is derived from Genability.
    - `utility_rate` string — Name of the specific utility rate/plan that the homeowner is on, before going solar.
    - `utility_rate_id` string, uuid — Unique ID of the specific utility rate/plan that the homeowner is on, before going solar. Field is omitted if utility rate is derived from Genability.
    - `utility_rate_version` string — Specific time interval that the homeowner was referring to, when providing energy (kWh) or bill information of a given month. The effective time interval of the utility rate that was used in the calculation of the consumption profile.
    - `utility_rate_version_id` string, uuid — Unique ID of the specific time interval that the homeowner was referring to, when providing energy (kWh) or bill information of a given month.
    - `input_mode` 'bill' | 'energy' — Indicates whether the user inputed "bill" or "energy" values during the creation of the consumption profile.
    - `input_values` number[] — Specifies which values of either "bill" or "energy" were manually entered by the user. "null" is returned for values that were computed by Aurora without the explicit input of the user.
    - `monthly_energy` number[] — Monthly consumption of energy in kWh from Jan - Dec.
    - `monthly_bill` number[] — Monthly bill in USD from Jan - Dec.
    - `hourly_energy` number[] — Energy consumption in kWh broken down by hour (8760 values)
    - `efficiency_packages` object[] — A list of efficiency packages applied to this consumption profile.
      - `efficiency_package_name` string — Name of the efficiency package.
      - `efficiency_package_value` number, double — Value in percent of the efficiency package.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/aurorasolar/apis/sync-api.md) · [All operations](https://skmtc.dev/aurorasolar/apis/sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aurorasolar/sync-api/revisions/5b41808d104d/schema)