Developer resources
Developer tools

Read a transaction's event timeline

get/v1/tenants/{tenant_id}/transactions/{transaction_id}/events
Requires an API key

The charger's transaction messages as one timeline, oldest first: OCPP 1.6 StartTransaction and StopTransaction (meter_wh is the raw register in Wh) and OCPP 2.x TransactionEvent Started, Updated and Ended (trigger_reason, seq_no, charging_state). ID tokens are masked. Meter readings are at .../meter-values.

Path parameters

  • tenant_idintegerRequired
  • transaction_idintegerRequired

Returns · 200

  • transaction_idintegerRequired
  • dataarray of TransactionEventRecordRequired
    Oldest first by the charger's timestamp.
    Child attributes
    • kindenumRequired
      One of started, updated, ended
    • atstring | nullRequired
      The charger's timestamp for the message.
    • messageenumRequired
      One of StartTransaction, StopTransaction, TransactionEvent
    • id_tokenstring | nullRequired
      The ID token's last 4 characters behind ****; the full value is never returned.
    • meter_whinteger | nullRequired
      OCPP 1.6 StartTransaction meterStart or StopTransaction meterStop: the raw register in Wh.
    • reasonstring | nullRequired
      Stop reason (OCPP 1.6 reason, OCPP 2.x stoppedReason).
    • trigger_reasonstring | nullRequired
      OCPP 2.x triggerReason.
    • seq_nointeger | nullRequired
    • charging_statestring | nullRequired
    • offlineboolean | nullRequired
    • number_of_phasesinteger | nullRequired
  • truncatedbooleanRequired
    More than 500 OCPP 2.x TransactionEvents: only the first 500 are listed.
GET /v1/tenants/{tenant_id}/transactions/{transaction_id}/events
curl --fail-with-body "https://api.ivoracharge.com/v1/tenants/1042/transactions/1/events" \
  -H "Authorization: Bearer $IVORA_API_KEY"
Response · 200
{
  "transaction_id": 1,
  "data": [
    {
      "kind": "started",
      "at": "string",
      "message": "StartTransaction",
      "id_token": "string",
      "meter_wh": 7500,
      "reason": "string",
      "trigger_reason": "string",
      "seq_no": 1,
      "charging_state": "string",
      "offline": false,
      "number_of_phases": 1
    }
  ],
  "truncated": false
}
Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.