Sign in

v1

latestOpenAPI 3.1.02026-07-264793109.1 KB
4. Assets

Asset Event

Send notification of an event happening on an asset.

This endpoint allows reporting various events related to an asset, such as:

  • Plug-in/plug-out events
  • Updates to charging intent
  • Charge now events

If a tariff is included, it must comply with the OSM opening hours standard (https://wiki.openstreetmap.org/wiki/Key:opening_hours) for off-peak times and have a valid timezone, or a 400 error will be returned.

post/entities/asset/{asset_id}/event

Path parameters

asset_idstring uuid required

Request body

event_type'plug_in' | 'plug_out' | 'intent_update' | 'charge_now' | 'charge_now_deleted' required

An enumeration.

end_atstring date-time

End time for the charge. This should only be included for "charge_now" events

Response

Event successfully processed

{"stackTrail":"paths:/entities/asset/{asset_id}/event:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}