Get Event Timestamp
++++++++++++++++++

.. jsonschema:: ../../../schemas/GetEventTimestampRequest.json
   :hide_key: /**/additionalProperties

.. admonition:: Feature enablement (Device Model)
    :class: note

    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"
        }
    }

.. jsonschema:: ../../../schemas/GetEventTimestampResponse.json
   :hide_key: /**/additionalProperties

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"
        }
    }

.. admonition:: Timestamp format
   :class: note

   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.