GET /device/:id

Returns the basic device information including status and location.

Resource URL

https://production-connect.blacklinesafety.com/1/device/:id

Parameters

id required

The id of the device. Example Value: 555

Example Request

GET	https://production-connect.blacklinesafety.com/1/device/555?access_token=abcd

Example Response

Note:

Possible alerts include: emergency_alert, fall_detected_alert, logoff, logon, low_battery, missed_check_in, network_timeout, no_motion_occurred, silent_alert gas_alert_detected over_limit_gas_alert_detected twa_alert_detected stel_alert_detected

date_last_seen, position_date, and date_last_modified represent the timestamp of the event in your timezone (according to the preference in your account). These values are deprecated.
Please use date_last_seen_utc, position_date_utc, and date_last_modified_utc instead. These are the timestamps of the events in UTC.

The values for beacon_battery are:

• 0 means the battery level is good
• 1 means the battery level is low
• Any other value means the battery level is unknown

{
    "id":1234,
    "type":"loner_is",
    "name":"Jim Parsons",
    "status":{
        "date_last_seen":"2012-07-03 16:38:28",
        "date_last_seen_utc":"2012-07-03 16:38:28",
        "is_online":false,
        "shutdown_reason":"no_shutdown",
        "location":{
            "type":"gps",
            "heading":0,
            "speed":0,
            "satellite_count":6,
            "position_date":"2012-07-03 16:25:58",
            "position_date_utc":"2012-07-03 16:25:58",
            "latitude":"51.0379619",
            "longitude":"-114.0343229",
            "altitude":1055
        },
        "battery":{
            "internal_level":80,
            "is_charging":false
        }
    },
    "contact":{
        "id":9000,
        "full_name":"Jack Doe",
        "first_name":"Jack",
        "last_name":"Doe",
        "phone_number":"403-123-4567"
    },
    "alerts":[
        {
            "id":69333,
            "status":"unacknowledged",
            "type":"logon",
            "date_last_modified":"2012-07-02 13:41:04",
            "date_last_modified_utc":"2012-07-02 13:41:04"
        }
    ],
    "owner":{
        "id":770,
        "first_name":"the_org_name",
        "last_name":"the_org_name",
        "email":"",
        "language":"",
        "timezone":"America/Denver",
        "org_id":770,
        "org_name":"the_org_name"
    }
}

{
    "id":5002,
    "type":"loner_m7",
    "name":"The 5002",
    "status":{
        "date_last_seen":"2018-11-14 17:06:36",
        "date_last_seen_utc":"2018-11-14 17:06:36",
        "is_online":true,
        "shutdown_reason":"network_timeout",
        "location":{
            "type":"ant",
            "beacon_id":1369002423,
            "beacon_name":"Bacon 1369002423",
            "beacon_address":"123 Sesame Street",
            "beacon_battery":0,
            "beacon_rssi":-66,
            "latitude":"51.0383210",
            "longitude":"-114.0337217",
            "altitude":null,
            "position_date":"2018-11-14 17:06:35",
            "position_date_utc":"2018-11-14 17:06:35"
        },
        "sensors":[
            {
                "gas_type":"CO",
                "reading":0,
                "units":"ppm",
                "date_utc":"2018-11-14 17:06:36"
            },
            {
                "gas_type":"H2S",
                "reading":0,
                "units":"ppm",
                "date_utc":"2018-11-14 17:06:36"
            },
            {
                "gas_type":"O2",
                "reading":20.9,
                "units":"vol",
                "date_utc":"2018-11-14 17:06:36"
            },
            {
                "gas_type":"LEL",
                "reading":0,
                "units":"lel",
                "date_utc":"2018-11-14 17:06:36"
            }
        ],
        "battery":{
            "internal_level":40,
            "is_charging":false
        }
    },
    "alerts":[],
    "owner":{
        "id":86,
        "first_name":"First",
        "last_name":"Last",
        "email":"",
        "language":"",
        "timezone":"America/Denver",
        "org_id":86,
        "org_name":"the_org_name"
    }
}