Get Event Timestamp

GetEventTimestampRequest

Topic: ocpp/cs. Used by OCPP to request from the CS the timestamp associated with a specific event.

type

object

properties

  • id

type

string

format

uuid

  • name

const

get_event_timestamp

  • type

const

request

  • data

type

object

properties

  • event_type

enum

TxEventStart, TxEventStop

  • trigger_reason

enum

EVConnected, Authorized, ParkingBayOccupancy, PowerPathClosed, EnergyTransfer, DataSigned

Feature enablement (Device Model)

This request can be enabled/disabled in OCPP service through the Device Model boolean variable EnableGetEventTimestampRequest under component JOSEV_CTRLR.

Example values:

  • true: OCPP service is allowed to send get_event_timestamp requests.

  • false: OCPP service will not send get_event_timestamp requests.

Used by OCPP to request from the OEM the timestamp associated with a specific event.

Example:

{
    "id": "a504f1cd-2ae0-46cf-a93c-736a28723478",
    "name": "get_event_timestamp",
    "type": "request",
    "data": {
        "event_type": "TxEventStart", # or "TxEventStop"
        "trigger_reason": "EVConnected" # or "Authorized", "ParkingBayOccupancy", "PowerPathClosed", "EnergyTransfer", "DataSigned"
    }
}

GetEventTimestampResponse

Topic: cs/ocpp. Used by the CS to return the timestamp for a previously requested event.

type

object

properties

  • id

type

string

format

uuid

  • name

const

get_event_timestamp

  • type

const

response

  • data

type

object

properties

  • timestamp

RFC3339 UTC timestamp. Fractional seconds are optional and limited to a maximum of 3 decimal places. Time zone designator ‘Z’ is required.

type

string

pattern

^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d{1,3})?Z$

format

date-time

Used by the OEM to return the timestamp for the requested event.

Example:

{
    "id": "a504f1cd-2ae0-46cf-a93c-736a28723478",
    "name": "get_event_timestamp",
    "type": "response",
    "data": {
        "timestamp": "2026-02-17T10:20:30.123Z"
    }
}

Timestamp format

The response timestamp must be RFC3339 compliant and expressed in UTC using the Z designator. Fractional seconds are optional, and when present must not exceed 3 decimal places.