Skip to main content

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

FieldTypeDescription
idintegerInternal device ID
namestringDisplay name of the device
uniqueIdstringIMEI or serial number
statusstringDevice status: online or offline
lastUpdatestringTimestamp of last update
positionIdintegerID of the last known position
groupIdintegerID of the group the device belongs to
disabledbooleanIndicates 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 id field to reference devices in other API calls.
  • Devices must be assigned to your user account to appear in the list.