---
title: "Retrieve statistics related to a charge point"
method: GET
path: "/api/v1/charge-point-statistics/by-charge-point"
tags: ["Charge Point Statistics"]
---

# Retrieve statistics related to a charge point

`GET /api/v1/charge-point-statistics/by-charge-point`

Required scope: `charge-points:read`

## Query parameters

- `chargePointId` integer, required — Filter to retrieve statistics for a given charge point by `chargePointId`
- `fromDate` string, date, required — Filter to retrieve charge point statistics created from date (YYYY-MM-DD), we expect a date in UTC</br>The maximum gap between from and to data cannot be longer than 365 days
- `toDate` string, date, required — Filter to retrieve charge point statistics created to date (YYYY-MM-DD), we expect a date in UTC</br>The maximum gap between from and to data cannot be longer than 365 days

## Response `200`

Statistics that match the provided criteria

- ChargePointStatisticsDto
  - `chargePointId` integer — Id of the charge point
  - `siteId` integer, nullable — Id of the site
  - `fromDate` string, date-time, required — Start date of the statistics period
  - `toDate` string, date-time, required — End date of the statistics period
  - `totalEnergyConsumed` number, required — Total energy consumed during the period (in kWh)
  - `totalSessions` integer, required — Total number of charging sessions during the period
  - `sessionSuccessRate` number, double, required — Success rate of charging sessions during the period (as a percentage)
  - `systemUptimePercentage` number, double, nullable — Percentage of uptime for the system during the period
  - `states` States[] — Detailed state for the period
    - `state` string, required — State of the system or charge point
    - `percentage` number, required — Percentage of the time spent in this state
    - `duration` integer, required — Duration in this state (in seconds)
  - `exemptState` ExemptState
    - `percentage` number, required — Percentage of the time spent in exempt state
    - `duration` integer, required — Duration in exempt state (in seconds)
  - `days` TimePeriod[] — Daily statistics for the period
    - `date` string, date-time, required — Date for the statistics
    - `dailyPerformance` Performance[], required — Performance metrics for the day
      - `status` string, required — State of the system or charge point
      - `duration` integer, required — Duration in the given status (in seconds)
      - `usagePercentage` number, required — Percentage of time in this state
  - `months` TimePeriod[] — Monthly statistics for the period
    - `date` string, date-time, required — Date for the statistics
    - `dailyPerformance` Performance[], required — Performance metrics for the day
      - `status` string, required — State of the system or charge point
      - `duration` integer, required — Duration in the given status (in seconds)
      - `usagePercentage` number, required — Percentage of time in this state

## 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.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)