Send local authorization list

import requests
url = "https://host.com/ocpp/commands/local-auth-list"
payload = {
    "target": { "charger_id": "dep-123" },
    "event": {
        "list_version": 2,
        "entries": [
            {
                "id_tag": "TAG-RFID-001",
                "expiry_date": "2026-12-31T23:59:59Z"
            },
            {
                "id_tag": "TAG-RFID-002",
                "expiry_date": "2026-06-30T23:59:59Z"
            }
        ]
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "status": "Accepted",
  "list_version": 2,
  "entries_received": 2
}

Send a local authorization list update to the selected charger. list_version must increase on each update so the charger can detect stale pushes.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

targetobjectRequired

Single-charger target for command endpoints that do not support locations.

eventobjectRequired

Command payload for local authorization list upload.

Response

Local auth list sent

statusstring or null

list_versioninteger or null

entries_receivedinteger or null

msgstring or null

entries_deletedinteger or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

1	import requests
2
3	url = "https://host.com/ocpp/commands/local-auth-list"
4
5	payload = {
6	"target": { "charger_id": "dep-123" },
7	"event": {
8	"list_version": 2,
9	"entries": [
10	{
11	"id_tag": "TAG-RFID-001",
12	"expiry_date": "2026-12-31T23:59:59Z"
13	},
14	{
15	"id_tag": "TAG-RFID-002",
16	"expiry_date": "2026-06-30T23:59:59Z"
17	}
18	]
19	}
20	}
21	headers = {
22	"Authorization": "Bearer <token>",
23	"Content-Type": "application/json"
24	}
25
26	response = requests.post(url, json=payload, headers=headers)
27
28	print(response.json())

1	{
2	"status": "Accepted",
3	"list_version": 2,
4	"entries_received": 2
5	}