Start transaction | OCPPLab Docs

import requests
url = "https://host.com/ocpp/commands/start-transaction"
payload = {
    "target": { "charger_id": "dep-789" },
    "event": {
        "id_tag": "RFID-2024-07",
        "evse_id": 2,
        "connector_id": 1
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "targeted_count": 1,
  "queued_count": 1,
  "failed_count": 0,
  "results": [
    {
      "charger_id": "dep-123",
      "identity": "CP-TEST-001",
      "command": {
        "id": "a1b2c3d4e5f6",
        "event_type": "start_transaction",
        "ocpp_version": "ocpp1.6",
        "payload": {
          "id_tag": "TAG-RFID-001",
          "evse_id": 1,
          "connector_id": 1
        }
      }
    }
  ],
  "failed": []
}

Send a raw OCPP StartTransaction request for the targeted charger(s). Lower-level than start-session: the caller drives plug/authorize manually. Targets a single charger, selected chargers in a location, or all chargers in a location.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

targetobjectRequired

Target for a unified command.

Provide exactly one of charger_id or location_id. charger_ids is an optional subset filter — only valid with location_id.

Examples::

{“charger_id”: “dep-123”} {“location_id”: “loc-456”} {“location_id”: “loc-456”, “charger_ids”: [“dep-1”, “dep-2”]}

eventobjectRequired

Command payload for start-transaction.

Response

Command accepted and queued for the target charger(s)

targeted_countinteger

queued_countinteger

failed_countinteger

resultslist of objects

failedlist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error