Upload up to 100 saved events in one request

POST

/device/scan/batch

Live on the backend; use it when the firmware is ready. 2xx only if every event was stored
(duplicates count as stored). On error, resend the same group.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

All stored

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404UnknownDevice

🟠429RateLimited

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/device/scan/batch' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": "MyDevice-A0CDCB",
    "events": [
        {
            "uid": 12,
            "timestamp": "2026-10-05T08:01:10Z",
            "time_trusted": true
        },
        {
            "uid": 7,
            "timestamp": "2026-10-05T08:03:44Z",
            "time_trusted": true
        }
    ]
}'

Response Example

200 - Success

{
    "status": "ok",
    "received": 2,
    "duplicates": 0
}

Modified at 2026-10-07 14:49:40

Send one attendance event

Report the outcome of each command