Charge Point Statistics

GET

https://partner-api.monta.com

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

Required scope: charge-points:read

chargePointId

integer · int64 · required

Filter to retrieve statistics for a given charge point by chargePointId

Example: 123

fromDate

string · date · pattern: \d{4}-\d{2}-\d{2} · required

Filter to retrieve charge point statistics created from date (YYYY-MM-DD), we expect a date in UTC
The maximum gap between from and to data cannot be longer than 365 days

Example: 2022-05-01

toDate

string · date · pattern: \d{4}-\d{2}-\d{2} · required

Filter to retrieve charge point statistics created to date (YYYY-MM-DD), we expect a date in UTC
The maximum gap between from and to data cannot be longer than 365 days

Example: 2022-05-30

Statistics that match the provided criteria

ChargePointStatisticsDto

fromDate

string · date-time · required

Start date of the statistics period

Example: 2024-03-20T00:00:00Z

toDate

string · date-time · required

End date of the statistics period

Example: 2024-03-30T00:00:00Z

totalEnergyConsumed

number · required

Total energy consumed during the period (in kWh)

Example: 500.5

totalSessions

integer · int32 · required

Total number of charging sessions during the period

Example: 150

sessionSuccessRate

number · double · required

Success rate of charging sessions during the period (as a percentage)

Example: 95

chargePointId

integer · int64

Id of the charge point

Example: 42

siteId

integer | null · int64

Id of the site

Example: 42

systemUptimePercentage

number | null · double

Percentage of uptime for the system during the period

Example: 99.9

States[]

Detailed state for the period

object

Detailed state that is exempt from uptime calculations

TimePeriod[]

Daily statistics for the period

TimePeriod[]

Monthly statistics for the period

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

curl 'https://partner-api.monta.com/api/v1/charge-point-statistics/by-charge-point?chargePointId=<number>&fromDate=<string>&toDate=<string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "chargePointId": 42,
  "siteId": 42,
  "fromDate": "2024-03-20T00:00:00Z",
  "toDate": "2024-03-30T00:00:00Z",
  "totalEnergyConsumed": 500.5,
  "totalSessions": 150,
  "sessionSuccessRate": 95,
  "systemUptimePercentage": 99.9,
  "states": [
    {
      "state": "operational",
      "percentage": 75,
      "duration": 3600
    }
  ],
  "exemptState": {
    "percentage": 75,
    "duration": 3600
  },
  "days": [
    {
      "date": "2024-03-30T00:00:00Z",
      "dailyPerformance": [
        {
          "status": "operational",
          "duration": 3600,
          "usagePercentage": 75
        }
      ]
    }
  ],
  "months": [
    {
      "date": "2024-03-30T00:00:00Z",
      "dailyPerformance": [
        {
          "status": "operational",
          "duration": 3600,
          "usagePercentage": 75
        }
      ]
    }
  ]
}

json

application/json

GET

https://partner-api.monta.com

/api/v1/charge-point-statistics/by-site

Required scope: charge-points:read

siteId

integer · int64 · required

Filter to retrieve statistics for a given site by siteId

Example: 45

fromDate

string · date · pattern: \d{4}-\d{2}-\d{2} · required

Filter to retrieve charge point statistics created from date (YYYY-MM-DD), we expect a date in UTC
The maximum gap between from and to data cannot be longer than 365 days

Example: 2022-05-01

toDate

string · date · pattern: \d{4}-\d{2}-\d{2} · required

Filter to retrieve charge point statistics created to date (YYYY-MM-DD), we expect a date in UTC
The maximum gap between from and to data cannot be longer than 365 days

Example: 2022-05-30

Statistics that match the provided criteria

SiteStatisticsDto

fromDate

string · date-time · required

Start date of the statistics period

Example: 2024-03-20T00:00:00Z

toDate

string · date-time · required

End date of the statistics period

Example: 2024-03-30T00:00:00Z

totalEnergyConsumed

number · required

Total energy consumed during the period (in kWh)

Example: 500.5

totalSessions

integer · int32 · required

Total number of charging sessions during the period

Example: 150

sessionSuccessRate

number · double · required

Success rate of charging sessions during the period (as a percentage)

Example: 95

siteId

integer | null · int64

Id of the site

Example: 42

systemUptimePercentage

number | null · double

Percentage of uptime for the system during the period

Example: 99.9

States[]

Detailed state for the period

TimePeriod[]

Daily statistics for the period

TimePeriod[]

Monthly statistics for the period

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

curl 'https://partner-api.monta.com/api/v1/charge-point-statistics/by-site?siteId=<number>&fromDate=<string>&toDate=<string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "siteId": 42,
  "fromDate": "2024-03-20T00:00:00Z",
  "toDate": "2024-03-30T00:00:00Z",
  "totalEnergyConsumed": 500.5,
  "totalSessions": 150,
  "sessionSuccessRate": 95,
  "systemUptimePercentage": 99.9,
  "states": [
    {
      "state": "operational",
      "percentage": 75,
      "duration": 3600
    }
  ],
  "days": [
    {
      "date": "2024-03-30T00:00:00Z",
      "dailyPerformance": [
        {
          "status": "operational",
          "duration": 3600,
          "usagePercentage": 75
        }
      ]
    }
  ],
  "months": [
    {
      "date": "2024-03-30T00:00:00Z",
      "dailyPerformance": [
        {
          "status": "operational",
          "duration": 3600,
          "usagePercentage": 75
        }
      ]
    }
  ]
}

json

application/json

Charge Point Models Charge Points

Charge Point Statistics

Retrieve statistics related to a charge point

Retrieve statistics related to a charge point › query Parameters

Retrieve statistics related to a charge point › Responses

Retrieve statistics related to a site

Retrieve statistics related to a site › query Parameters

Retrieve statistics related to a site › Responses