Get controller details

GET

/controllers/{controllerId}

Retrieve detailed information about a specific lock controller

Request

Authorization

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

API Key

Add parameter in header

X-Session-Token

Example:

X-Session-Token: ********************

Path Params

Responses

🟢200OK

application/json

Controller details

Body

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/controllers/' \
--header 'Authorization: Basic <encoded-value>'

Response Example

200 - Example 1

{
    "id": 0,
    "name": "string",
    "hostname": "string",
    "ipAddress": "string",
    "port": 8080,
    "operational": true,
    "operationalLastChecked": "2019-08-24T14:15:22Z",
    "lastSeen": "2019-08-24T14:15:22Z",
    "reasonCode": "CONTROL_BOARD_UNREACHABLE",
    "reason": "string",
    "lockerCount": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
}

Modified at 2025-11-27 00:06:25

Trigger manual mDNS scan

Update controller settings