GET /device

Returns the basic information for all your devices.

Resource URL

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

Parameters

None

Example Request

GET https://production-connect.blacklinesafety.com/1/device?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: 

  1. [
  2.     {
  3.         "id":1234,
  4.         "type":"loner_is",
  5.         "name":"Jim Parsons",
  6.         "status":{
  7.             "date_last_seen":"2012-07-03 16:38:28",
  8.             "date_last_seen_utc":"2012-07-03 22:38:28",
  9.             "is_online":false,
  10.             "shutdown_reason":"no_shutdown",
  11.             "location":{
  12.                 "type":"gsm",
  13.                 "timing_advance":4,
  14.                 "uncertainty":555,
  15.                 "position_date":"2012-07-03 16:26:56",
  16.                 "position_date_utc":"2012-07-03 22:26:56",
  17.                 "latitude":"51.0433050",
  18.                 "longitude":"-114.0198290",
  19.                 "altitude":0
  20.             },
  21.             "battery":{
  22.                 "internal_level":80,
  23.                 "is_charging":false
  24.             }
  25.         },
  26.         "contact":[],
  27.         "alerts":[],
  28.         "owner":{
  29.             "id":770,
  30.             "first_name":"the_org_name",
  31.             "last_name":"the_org_name",
  32.             "email":"",
  33.             "language":"",
  34.             "timezone":"America/Denver",
  35.             "org_id":770,
  36.             "org_name":"the_org_name"
  37.         }
  38.     },
  39.     {
  40.         "id":3422,
  41.         "type":"loner_is",
  42.         "name": "",
  43.         "status":{
  44.             "date_last_seen":"2012-07-04 12:22:09",
  45.             "date_last_seen_utc":"2012-07-04 18:22:09",
  46.             "is_online":true,
  47.             "shutdown_reason":"no_shutdown",
  48.             "location":{
  49.                 "type":"gps",
  50.                 "heading":0,
  51.                 "speed":0,
  52.                 "satellite_count":6,
  53.                 "position_date":"2012-07-03 16:25:58",
  54.                 "position_date_utc":"2012-07-03 22:25:58",
  55.                 "latitude":"51.0379619",
  56.                 "longitude":"-114.0343229",
  57.                 "altitude":1055
  58.             },
  59.             "battery":{
  60.                 "internal_level":40,
  61.                 "is_charging":true
  62.             }
  63.         },
  64.         "contact":{
  65.             "id":9000,
  66.             "full_name":"Jack Doe",
  67.             "first_name":"Jack",
  68.             "last_name":"Doe",
  69.             "phone_number":"403-123-4567"
  70.         },
  71.         "alerts":[
  72.             {
  73.                 "id": 733,
  74.                 "status":"acknowledged",
  75.                 "type":"emergency_alert",
  76.                 "date_last_modified":"2012-07-03 12:08:52",
  77.                 "date_last_modified_utc":"2012-07-03 18:08:52"
  78.             }
  79.         ],
  80.         "owner":{
  81.             "id":770,
  82.             "first_name":"the_org_name",
  83.             "last_name":"the_org_name",
  84.             "email":"",
  85.             "language":"",
  86.             "timezone":"America/Denver",
  87.             "org_id":770,
  88.             "org_name":"the_org_name"
  89.         }
  90.     },
  91.     {
  92.         "id":5002,
  93.         "type":"loner_m7",
  94.         "name":"The 5002",
  95.         "status":{
  96.             "date_last_seen":"2018-11-14 10:06:36",
  97.             "date_last_seen_utc":"2018-11-14 17:06:36",
  98.             "is_online":true,
  99.             "shutdown_reason":"network_timeout",
  100.             "sensors":[
  101.                 {
  102.                     "gas_type":"CO",
  103.                     "reading":0,
  104.                     "units":"ppm",
  105.                     "date_utc":"2018-11-14 17:06:36"
  106.                 },
  107.                 {
  108.                     "gas_type":"H2S",
  109.                     "reading":0,
  110.                     "units":"ppm",
  111.                     "date_utc":"2018-11-14 17:06:36"
  112.                 },
  113.                 {
  114.                     "gas_type":"O2",
  115.                     "reading":20.9,
  116.                     "units":"vol",
  117.                     "date_utc":"2018-11-14 17:06:36"
  118.                 },
  119.                 {
  120.                     "gas_type":"LEL",
  121.                     "reading":0,
  122.                     "units":"lel",
  123.                     "date_utc":"2018-11-14 17:06:36"
  124.                 }
  125.             ],
  126.             "location":{
  127.                 "type":"ant",
  128.                 "beacon_id":1369002423,
  129.                 "beacon_name":"Bacon 1369002423",
  130.                 "beacon_address":"123 Sesame Street",
  131.                 "beacon_battery":0,
  132.                 "beacon_rssi":-66,
  133.                 "position_date":"2018-11-14 10:06:35",
  134.                 "position_date_utc":"2018-11-14 17:06:35",
  135.                 "latitude":"51.0383210",
  136.                 "longitude":"-114.0337217",
  137.                 "altitude":0
  138.             },
  139.             "battery":{
  140.                "internal_level":40,
  141.                "is_charging":false
  142.             }
  143.         },
  144.         "contact":[],
  145.         "alerts":[],
  146.         "owner":{
  147.             "id":770,
  148.             "first_name":"First",
  149.             "last_name":"Last",
  150.             "email":"",
  151.             "language":"",
  152.             "timezone":"America/Denver",
  153.             "org_id":770,
  154.             "org_name":"the_org_name"
  155.         }
  156.     }
  157. ]