Skip to content
TAMsys — Asset Monitoring SystemTAMsys Developer

Device endpoints

All endpoints require the X-API-KEY header. Examples use https://api.tamsys.app/p as the base URL.

List devices

Section titled “List devices”

Return metadata for every device assigned to the authenticated company.

GET/p/devices/list
Terminal window
curl 'https://api.tamsys.app/p/devices/list' \
  --header 'X-API-KEY: your-api-key'

Example response

Section titled “Example response”
[
  {
    "id": "00:E0:12:34:56:ED",
    "deviceID": "00:E0:12:34:56:ED",
    "deviceName": "Reefer 12",
    "entityType": "tracker",
    "status": 1,
    "temp": 4.6,
    "speed": 42,
    "voltage": 12.7,
    "location": "Navi Mumbai, Maharashtra",
    "updatedAt": 1785488711000,
    "inAlert": false,
    "inAlarm": false
  }
]

Device records may also include chillerStatus, ignitionStatus, energy, coilTemperature, compliancePct, doorOpenPct, createdAt, expiresOn, masterLat, masterLng, masterAddress, and device-type-specific attributes.

Get all latest readings

Section titled “Get all latest readings”

Return the newest available telemetry record for each device assigned to the authenticated company.

GET/p/devices/data
Terminal window
curl 'https://api.tamsys.app/p/devices/data' \
  --header 'X-API-KEY: your-api-key'

Example response

Section titled “Example response”
[
  {
    "id": "00:E0:12:34:56:ED",
    "utctimestamp": 1785488704000,
    "temp": 4.6,
    "latitude": 19.1395068,
    "longitude": 73.0142075,
    "speed": 42,
    "heading": 186
  }
]

Devices without telemetry are omitted from the array.

Get one latest reading

Section titled “Get one latest reading”

Return the newest telemetry record for one device. The device must be assigned to the authenticated company.

GET/p/devices/{id}/data
Terminal window
curl 'https://api.tamsys.app/p/devices/00%3AE0%3A12%3A34%3A56%3AED/data' \
  --header 'X-API-KEY: your-api-key'

The request returns a telemetry object with 200, or an empty JSON object with 404 when the device is not assigned to the company or has no reading.

Get multiple latest readings

Section titled “Get multiple latest readings”

Return the newest telemetry record for selected devices in one request.

GET/p/devices/multiple/data?ids={id1},{id2}
Query parameter Type Required Description
ids string Yes Comma-separated device IDs; maximum 100 IDs
Terminal window
curl --get 'https://api.tamsys.app/p/devices/multiple/data' \
  --data-urlencode 'ids=TES001,TES002,TES003' \
  --header 'X-API-KEY: your-api-key'

Only devices assigned to the authenticated company are queried. Unknown or unassigned IDs are filtered out when at least one requested ID is valid. Devices without a latest telemetry record are omitted.

Error cases

Section titled “Error cases”
  • Missing ids returns 400 with {"error":"ids query parameter is required"}.
  • More than 100 IDs returns 400 with the received count and limit.
  • No valid assigned device IDs returns 404 with {"error":"No valid devices found"}.