Energy Monitoring

Get charge history for an EVSE

GET

https://partner-api.monta.com

/api/v1/energy/sites/{siteId}/evses/{chargePointIdentity}/{connectorId}/charges

Required scope: energy:read

🔍 For Monta Energy Management dashboards. This endpoint exists to power the Monta Energy frontend and is redundant with the general GET /charges endpoint. For general charge history retrieval, use GET /charges instead.

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

📘 Feature flag required — This endpoint is not available by default. It must be explicitly enabled for your operator account upon request. Please contact your Monta Business Partner to request access to this feature.

Get charge history for an EVSE › path Parameters

siteId

integer · int64 · required

chargePointIdentity

string · required

connectorId

integer · int32 · required

Get charge history for an EVSE › query Parameters

startAt

string | null · date-time

endAt

string | null · date-time

search

string | null

status

string | null

size

integer | null · int32

before

string | null

after

string | null

Get charge history for an EVSE › Responses

getEvseChargeHistory 200 response

CursorPage_ChargeHistoryItem_

ChargeHistoryItem[] · required

totalSize

integer · int64 · required

perPage

integer · int32 · required

currentSize

integer · int32 · required

before

string | null

after

string | null

GET/api/v1/energy/sites/{siteId}/evses/{chargePointIdentity}/{connectorId}/charges

curl https://partner-api.monta.com/api/v1/energy/sites/:siteId/evses/:chargePointIdentity/:connectorId/charges \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "content": [
    {
      "internalChargeId": 0,
      "ocppChargeId": "ocppChargeId",
      "phpChargeId": 0,
      "status": "status",
      "startTime": "2024-08-25T15:00:00Z",
      "endedAt": "2024-08-25T15:00:00Z",
      "startingSoc": 0,
      "startingWh": 0,
      "maxObservedPowerW": 0,
      "soc": 0,
      "vehicleId": 0,
      "chargePointIdentity": "chargePointIdentity",
      "connectorId": 0,
      "nodeName": "nodeName",
      "nodeId": 0,
      "totalPrice": 0,
      "currencyId": "currencyId",
      "ocppStatus": "ocppStatus",
      "ocppStatusAt": "2024-08-25T15:00:00Z"
    }
  ],
  "totalSize": 0,
  "perPage": 0,
  "currentSize": 0,
  "before": "before",
  "after": "after"
}

json

application/json

Get historical meter values for an EVSE

GET

https://partner-api.monta.com

/api/v1/energy/sites/{siteId}/evses/{chargePointIdentity}/{connectorId}/meter-values

Required scope: energy:read

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

Get historical meter values for an EVSE › path Parameters

siteId

integer · int64 · required

chargePointIdentity

string · required

connectorId

integer · int32 · required

Get historical meter values for an EVSE › query Parameters

from

string · date-time · required

to

string · date-time · required

Get historical meter values for an EVSE › Responses

getEvseMeterValues 200 response

HistoricalMeterValuesData

time

string[] · required

currentL1A

number[] · required

currentL2A

number[] · required

currentL3A

number[] · required

voltageL1V

number[] · required

voltageL2V

number[] · required

voltageL3V

number[] · required

powerL1W

number[] · required

powerL2W

number[] · required

powerL3W

number[] · required

powerW

number[] · required

kwh

number[] · required

soc

number[] · required

Export historical meter values for an EVSE as CSV

GET

https://partner-api.monta.com

/api/v1/energy/sites/{siteId}/evses/{chargePointIdentity}/{connectorId}/meter-values/export

Required scope: energy:read

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

Export historical meter values for an EVSE as CSV › path Parameters

siteId

integer · int64 · required

chargePointIdentity

string · required

connectorId

integer · int32 · required

Export historical meter values for an EVSE as CSV › query Parameters

from

string · date-time · required

to

string · date-time · required

Export historical meter values for an EVSE as CSV › Responses

exportEvseMeterValues 200 response

string

Get charge history for a node

GET

https://partner-api.monta.com

/api/v1/energy/sites/{siteId}/nodes/{nodeId}/charges

Required scope: energy:read

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

Get charge history for a node › path Parameters

siteId

integer · int64 · required

nodeId

integer · int64 · required

Get charge history for a node › query Parameters

startAt

string | null · date-time

endAt

string | null · date-time

search

string | null

status

string | null

size

integer | null · int32

before

string | null

after

string | null

Get charge history for a node › Responses

getNodeChargeHistory 200 response

CursorPage_ChargeHistoryItem_

ChargeHistoryItem[] · required

totalSize

integer · int64 · required

perPage

integer · int32 · required

currentSize

integer · int32 · required

before

string | null

after

string | null

GET/api/v1/energy/sites/{siteId}/nodes/{nodeId}/charges

curl https://partner-api.monta.com/api/v1/energy/sites/:siteId/nodes/:nodeId/charges \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "content": [
    {
      "internalChargeId": 0,
      "ocppChargeId": "ocppChargeId",
      "phpChargeId": 0,
      "status": "status",
      "startTime": "2024-08-25T15:00:00Z",
      "endedAt": "2024-08-25T15:00:00Z",
      "startingSoc": 0,
      "startingWh": 0,
      "maxObservedPowerW": 0,
      "soc": 0,
      "vehicleId": 0,
      "chargePointIdentity": "chargePointIdentity",
      "connectorId": 0,
      "nodeName": "nodeName",
      "nodeId": 0,
      "totalPrice": 0,
      "currencyId": "currencyId",
      "ocppStatus": "ocppStatus",
      "ocppStatusAt": "2024-08-25T15:00:00Z"
    }
  ],
  "totalSize": 0,
  "perPage": 0,
  "currentSize": 0,
  "before": "before",
  "after": "after"
}

json

application/json

Get EVSE state history for a node

GET

https://partner-api.monta.com

/api/v1/energy/sites/{siteId}/nodes/{nodeId}/evse-states

Required scope: energy:read

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

Get EVSE state history for a node › path Parameters

siteId

integer · int64 · required

nodeId

integer · int64 · required

Get EVSE state history for a node › query Parameters

startAt

string · date-time · required

endAt

string · date-time · required

Get EVSE state history for a node › Responses

getEvseStateHistory 200 response

EvseStateHistoryResponse

startAt

string · date-time · required

endAt

string · date-time · required

EvseStateMeasurement[] · required

Get historical meter values for a node

GET

https://partner-api.monta.com

/api/v1/energy/sites/{siteId}/nodes/{nodeId}/meter-values

Required scope: energy:read

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

Get historical meter values for a node › path Parameters

siteId

integer · int64 · required

nodeId

integer · int64 · required

Get historical meter values for a node › query Parameters

from

string · date-time · required

to

string · date-time · required

Get historical meter values for a node › Responses

getNodeMeterValues 200 response

HistoricalMeterValues

object

GET/api/v1/energy/sites/{siteId}/nodes/{nodeId}/meter-values

curl 'https://partner-api.monta.com/api/v1/energy/sites/:siteId/nodes/:nodeId/meter-values?from=<string>&to=<string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "externalMeter": {
    "time": [
      "2024-08-25T15:00:00Z"
    ],
    "currentL1A": [
      0
    ],
    "currentL2A": [
      0
    ],
    "currentL3A": [
      0
    ],
    "voltageL1V": [
      0
    ],
    "voltageL2V": [
      0
    ],
    "voltageL3V": [
      0
    ],
    "powerL1W": [
      0
    ],
    "powerL2W": [
      0
    ],
    "powerL3W": [
      0
    ],
    "powerW": [
      0
    ],
    "kwh": [
      0
    ],
    "soc": [
      0
    ]
  },
  "aggregatedEvse": {
    "time": [
      "2024-08-25T15:00:00Z"
    ],
    "currentL1A": [
      0
    ],
    "currentL2A": [
      0
    ],
    "currentL3A": [
      0
    ],
    "voltageL1V": [
      0
    ],
    "voltageL2V": [
      0
    ],
    "voltageL3V": [
      0
    ],
    "powerL1W": [
      0
    ],
    "powerL2W": [
      0
    ],
    "powerL3W": [
      0
    ],
    "powerW": [
      0
    ],
    "kwh": [
      0
    ],
    "soc": [
      0
    ]
  },
  "nodeThresholds": {
    "time": [
      "2024-08-25T15:00:00Z"
    ],
    "fuseLimitA": [
      0
    ],
    "bufferA": [
      0
    ],
    "powerLimitW": [
      0
    ],
    "powerLimitSchedule": [
      [
        {
          "dayOfWeek": "dayOfWeek",
          "startTime": "startTime",
          "endTime": "endTime",
          "powerLimitW": 0
        }
      ]
    ]
  },
  "evseAllocations": {
    "series": [
      {
        "evseId": "evseId",
        "time": [
          "2024-08-25T15:00:00Z"
        ],
        "allocatedPowerW": [
          0
        ],
        "allocatedCurrentA": [
          0
        ]
      }
    ]
  }
}

json

application/json

Export historical meter values for a node as CSV

GET

https://partner-api.monta.com

/api/v1/energy/sites/{siteId}/nodes/{nodeId}/meter-values/export

Required scope: energy:read

🚧 BETA — This endpoint is currently in the BETA phase and its response structure may change in the future.

Export historical meter values for a node as CSV › path Parameters

siteId

integer · int64 · required

nodeId

integer · int64 · required

Export historical meter values for a node as CSV › query Parameters

from

string · date-time · required

to

string · date-time · required

Export historical meter values for a node as CSV › Responses

exportNodeMeterValues 200 response

string

Energy Charge Intents Energy Sites