Authorize ID tag | OCPPLab Docs

import requests
url = "https://host.com/ocpp/commands/authorize-id-tag"
payload = {
    "target": { "charger_id": "dep-789" },
    "event": { "id_tag": "RFID-202406" }
}
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-789",
      "identity": "CP-CHARGER-789",
      "command": {
        "id": "f4e5d6c7b8a9",
        "event_type": "authorize",
        "ocpp_version": "ocpp1.6",
        "payload": {
          "id_tag": "RFID-202406"
        }
      }
    }
  ],
  "failed": []
}

Send an OCPP Authorize request with the given id_tag. The charger contacts the CSMS and returns an Accepted, Blocked, or Invalid status. 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 authorize-id-tag.

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