Transactions

Start and stop charging sessions remotely, and view transaction history. All endpoints require the X-API-Key header.

Remote start transaction

POST/api/v1/chargers/:chargeBoxId/remote-start

Start a charging session remotely on a specific connector.

Request body

json

{
  "connectorId": 1,
  "idTag": "USER123"
}

Parameter	Type	Description
`connectorId`*	number	The connector to start charging on
`idTag`*	string	User/RFID identifier for the session

The connector must be in Preparing status (cable plugged in and vehicle ready) for a remote start to succeed.

Response — 202 Accepted

json

{
  "message": "Remote start accepted by charger",
  "transactionId": 12345,
  "chargeBoxId": "CHARGER-001",
  "connectorId": 1,
  "status": "pending",
  "note": "Transaction will start when vehicle is connected and ready"
}

Remote stop transaction

POST/api/v1/transactions/:transactionId/stop

Stop an active charging session.

Response — 202 Accepted

json

{
  "message": "Remote stop accepted by charger",
  "transactionId": 12345,
  "chargeBoxId": "CHARGER-001",
  "status": "stopping",
  "note": "Transaction will stop shortly. Final details available after StopTransaction is received."
}

Get transaction details

GET/api/v1/transactions/:transactionId

Get full details of a specific transaction including energy delivered and duration.

Response — 200 OK

json

{
  "id": "txn_123",
  "transactionId": 12345,
  "chargeBoxId": "CHARGER-001",
  "connectorId": 1,
  "idTag": "USER123",
  "status": "completed",
  "meterStart": 1000,
  "meterStop": 15000,
  "energyDelivered": 14.0,
  "durationMinutes": 45,
  "startTime": "2026-02-06T12:00:00.000Z",
  "stopTime": "2026-02-06T12:45:00.000Z",
  "stopReason": "Local",
  "remoteStarted": true
}

List transactions

GET/api/v1/transactions

Get all transactions with optional filters.

Parameter	Type	Description
`chargeBoxId`	string	Filter by charger
`status`	string	Filter: active, completed, pending
`limit`	number	Results per page (default: 50)
`offset`	number	Pagination offset (default: 0)

Response — 200 OK

json

{
  "transactions": [
    {
      "id": "txn_123",
      "transactionId": 12345,
      "chargeBoxId": "CHARGER-001",
      "connectorId": 1,
      "idTag": "USER123",
      "status": "completed",
      "energyDelivered": 14.0,
      "durationMinutes": 45,
      "startTime": "2026-02-06T12:00:00.000Z",
      "stopTime": "2026-02-06T12:45:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Transaction statuses

Status	Description
`pending`	Remote start sent, waiting for charger to begin
`active`	Charging session is in progress
`completed`	Session finished (energy delivered, duration recorded)
`stopping`	Remote stop sent, waiting for charger to confirm