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.