Band/Bag Tags

Read-only lookup of a scanned Band/Bag Tags device by its serial number — returns who the device belongs to along with its associated the registry tags.

1 endpoint(s)

GET Get Band/Bag Tags Device Info {{url}}/utility/iot-info/4234234234 ▸

Look up a single Band/Bag Tags device (band/tag/tracker) by serial number, merging data from TerraGo's local stock and TerraGo's zone/location and tag registry so you can see whether it's registered, assigned, and its current status — even if one of the two sources is temporarily unavailable.

Path Parameters

serial_number (string, required): The device's serial number.

Response

{
  "stock": { "...": "local TerraGo stock record, if found" },
  "waas": { "...": "registry-side record, if found" },
  "flags": {
    "stock_exists": true,
    "waas_exists": true,
    "assigned": true,
    "status": "Online"
  }
}

Notes

If the registry is unreachable but the device exists in local stock, this still returns the local data with degraded flags rather than failing outright.
You must be an Administrative Staff (or their Staff) for the school that owns the device — returns 403 otherwise.

Auth

Bearer token

Sample Response (200 OK)

{
    "status": 200,
    "data": {
        "stock": {
            "id": "367c386e-dcbf-4e0e-bcda-7736ec666824",
            "serial_number": "4234234234",
            "earth_code": "7456745684",
            "batch_number": "42342342342",
            "color": "Wema Pink",
            "type": "Terra GO Wearable",
            "status": "in_use",
            "school": null,
            "dependant": {
                "id": "984caec7-91b5-4f9d-a8a5-3e69aa94419c",
                "name": "Faith Kilonzo",
                "gender": "Male",
                "dob": "2015-08-08 00:00:00",
                "third_party_id": "f8a9dca8-1fd2-43f8-ad58-f53b836db58a",
                "metadata": "{\"grade\":\"1st Grade\"}",
                "created_at": "2026-03-30 14:00:53",
                "updated_at": "2026-03-30 14:10:05"
            },
            "assigned_at": "2026-06-02 12:01:35",
            "created_at": "2026-05-29 08:44:15"
        },
        "waas": {
            "id": "ccf0814f-0fe3-4f96-a0b3-ee24ad871b77",
            "serial_number": "4234234234",
            "code": "IOT-B20C4A9A480",
            "status": "Active",
            "user_type": "Dependant",
            "account_id": "f8a9dca8-1fd2-43f8-ad58-f53b836db58a",
            "wallet_id": "f8a9dca8-1fd2-43f8-ad58-f53b836db58a",
            "expires_at": "Sat, Jun 2, 2035 9:01 AM",
            "validity": "8 years from now",
            "expired": false,
            "created_at": "Tue, Jun 2, 2026 12:01 PM",
            "iot_type": {
                "id": "4b02b052-2082-4706-bf33-a5d8bb14ee7e",
                "name": "Test"
            },
            "assignee": {
                "id": "f8a9dca8-1fd2-43f8-ad58-f53b836db58a",
                "name": "Faith Kilonzo",
                "third_party_id": "984caec7-91b5-4f9d-a8a5-3e69aa94419c",
                "tags": [
                    {
                        "id": "4e703369-78d2-4646-a937-9fc8abf78be8",
                        "name": "PM_School Ruiru - Migaa Route Route",
                        "color_code": null
                    }
                ]
            },
            "tags": []
        },
        "flags": {
            "stock_exists": true,
            "waas_exists": true,
            "assigned": true,
            "status": "in_use"
        }
    },
    "message": "IOT Info Fetched Successfully"
}