---
title: "Retrieve a charge kwh consumption breakdown"
method: GET
path: "/api/v1/charges/{chargeId}/kwh-consumption"
tags: ["Charges"]
---

# Retrieve a charge kwh consumption breakdown

`GET /api/v1/charges/{chargeId}/kwh-consumption`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/charges/{chargeId}/kwh-consumption`
- Auth: HTTP bearer

Required scope: `charges:read`. **Note:** Only available for charges performed on a Monta-connected (via OCPP) charge point.

## Path parameters

- `chargeId` integer, required

## Query parameters

- `consumptionPeriodSizeInSeconds` 3600 | 1800 | 900 | 600 | 300, nullable: Filter to retrieve kwh consumption by a given `consumptionPeriodSize` interval in seconds

## Response `200`

Charge kwh consumption breakdown for the given id

- ChargeKwhConsumption
  - `chargeId` number: Id of the charge
  - `consumptionPeriodSizeInSeconds` integer: Specifies the time interval, in seconds
  - `kwhConsumption` KwhConsumption[], nullable: Detailed breakdown of the kwh consumption in time interval of 5, 10, 15, 30 and 60 minutes</br>**Note**: Representation is in seconds, 3600 by default
    - `time` string, date-time, required: Time interval
    - `value` number, double: The amount of energy consumed (in kWh) during the corresponding time interval

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)