Get List of Devices
This endpoint returns all I LOCK IT devices assigned to the authenticated user.
Base URL
The base URL for all API calls is https://tracking.ilockit.bike/api/
Request
- Method:
GET - Endpoint:
/devices - Authentication: Basic (email + password)
Headers
accept: application/json
Authorization: Basic <base64(email:password)>
Response
The response is a JSON array with objects representing the user’s devices.
[
{
"id": 274,
"name": "I LOCK IT GPS",
"uniqueId": "868402030200001",
"status": "online",
"lastUpdate": "2024-02-06T12:31:05.000+0000",
"positionId": 2963985,
"groupId": 5,
"disabled": false
},
...
]
Response Fields
| Field | Type | Description |
|---|---|---|
id | integer | Internal device ID |
name | string | Display name of the device |
uniqueId | string | IMEI or serial number |
status | string | Device status: online or offline |
lastUpdate | string | Timestamp of last update |
positionId | integer | ID of the last known position |
groupId | integer | ID of the group the device belongs to |
disabled | boolean | Indicates if the device is currently disabled |
Example Request
curl -X GET 'https://tracking.ilockit.bike/api/devices' \
-H 'accept: application/json' \
-u user@example.com:yourPassword
Notes
- Devices are listed in no particular order.
- Use the
idfield to reference devices in other API calls. - Devices must be assigned to your user account to appear in the list.