List live operations

Returns live operational records for shifts and employees. Use filters such as date range, site, customer, employee name, subcontractor, and status to narrow results. If startDate or endDate is omitted, the API defaults to a 34-hour window around the current UTC time (now - 17 hours through now + 17 hours). Results support cursor-style pagination with referenceId, referenceDateTime, direction, and the nextPageParameter value returned by the previous response. Requires a public API key with KeyType=liveops.

GET

api

external

liveops

List live operations

curl --request GET \
  --url https://gateway-api.guardhousehq.com/api/external/liveops \
  --header 'Authorization: Bearer <token>' \
  --header 'external-gh-apim-sub-key: <api-key>'

import requests

url = "https://gateway-api.guardhousehq.com/api/external/liveops"

headers = {
    "Authorization": "Bearer <token>",
    "external-gh-apim-sub-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'external-gh-apim-sub-key': '<api-key>'}
};

fetch('https://gateway-api.guardhousehq.com/api/external/liveops', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway-api.guardhousehq.com/api/external/liveops",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "external-gh-apim-sub-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway-api.guardhousehq.com/api/external/liveops"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("external-gh-apim-sub-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://gateway-api.guardhousehq.com/api/external/liveops")
  .header("Authorization", "Bearer <token>")
  .header("external-gh-apim-sub-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway-api.guardhousehq.com/api/external/liveops")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["external-gh-apim-sub-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "isSuccess": true,
  "statusMessage": "<string>",
  "status": 123,
  "errorMessages": [
    {}
  ],
  "errorMessagesAsString": "<string>",
  "data": [
    {
      "companyName": "<string>",
      "name": "<string>",
      "siteName": "<string>",
      "customerName": "<string>",
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "timeIn": "2023-11-07T05:31:56Z",
      "timeOut": "2023-11-07T05:31:56Z",
      "status": "CLOCKED IN",
      "inSignatureUrl": "<string>",
      "outSignatureUrl": "<string>",
      "inPhotoUrl": "<string>",
      "outPhotoUrl": "<string>",
      "inLatitude": 123,
      "inLongitude": 123,
      "outLatitude": 123,
      "outLongitude": 123,
      "startTimeTZ": "2023-11-07T05:31:56Z",
      "endTimeTZ": "2023-11-07T05:31:56Z",
      "timeInTZ": "2023-11-07T05:31:56Z",
      "timeOutTZ": "2023-11-07T05:31:56Z",
      "subcontractorName": "<string>",
      "eventID": "<string>",
      "mobile": "<string>",
      "email": "jsmith@example.com",
      "address": "<string>",
      "calledAt": "2023-11-07T05:31:56Z",
      "calledBy": 123,
      "entryTypeID": 123,
      "isClockInOffSite": true,
      "isClockOutOffSite": true,
      "calledByFullName": "<string>",
      "inEnteredByFullName": "<string>",
      "outEnteredByFullName": "<string>",
      "licenses": [
        {}
      ],
      "welfareCheckResponses": [
        {
          "timesheetEntryId": 123,
          "welfareCheckId": 123,
          "dateSent": "2023-11-07T05:31:56Z",
          "hasResponse": true,
          "type": "<string>",
          "parentWelfareCheckId": 123,
          "managerCheck": true,
          "managerEmployee": "<string>",
          "followUps": [
            {}
          ]
        }
      ],
      "welfareCheckNotifResponses": [
        {
          "timesheetEntryId": 123,
          "welfareCheckId": 123,
          "dateSent": "2023-11-07T05:31:56Z",
          "hasResponse": true,
          "type": "<string>",
          "parentWelfareCheckId": 123,
          "managerCheck": true,
          "managerEmployee": "<string>",
          "followUps": [
            {}
          ]
        }
      ],
      "statusText": "<string>",
      "publishedShiftID": 123,
      "sitePositionName": "<string>",
      "shiftId": 123
    }
  ],
  "nextPageParameter": "<string>",
  "prevPageParameter": "<string>"
}

{
  "data": "<unknown>",
  "errors": [
    {
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "meta": {
    "traceId": "<string>",
    "timestampUtc": "2023-11-07T05:31:56Z",
    "nextPageEndpoint": "<string>",
    "prevPageEndpoint": "<string>"
  }
}

{
  "status": {
    "code": 123,
    "errorMessage": "<string>"
  },
  "data": "<unknown>",
  "count": 123,
  "message": "<string>",
  "errors": [
    {
      "code": 100,
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

JWT issued by POST /api/external/token/request. Send as Authorization: Bearer <token>.

external-gh-apim-sub-key

string

header

required

Guardhouse API Management subscription key. Required on every request. The same value is used by all API consumers within a region — contact Guardhouse Support for the subscription key.

Query Parameters

startDate

string<date-time>

Start date for filtering results (ISO-8601 date-time).

endDate

string<date-time>

End date for filtering results (ISO-8601 date-time).

siteName

string

Filter by site name.

siteId

string

Filter by site ID.

customerName

string

Filter by customer name.

customerId

string

Filter by customer ID.

fullName

string

Filter by employee full name.

subcontractorName

string

Filter by subcontractor name.

status

string

Filter by event status, such as CLOCKED IN.

limit

integer<int32>

default:100

Maximum number of records to return.

referenceId

integer<int32>

Unique ID of the last record received. Use with referenceDateTime to fetch records after this cursor.

referenceName

string

Cursor anchor name when paginating across name-sorted results.

referenceDateTime

string<date-time>

Timestamp of the last record received. Use with referenceId to fetch records after this cursor.

searchText

string

Free-text search filter.

direction

enum<string>

default:next

Cursor pagination direction.

Available options:

next,

prev

Response

Live operations response

Live Operations API envelope.

isSuccess

boolean

statusMessage

string

status

integer<int32>

errorMessages

object[]

errorMessagesAsString

string

data

object[]

Show child attributes

nextPageParameter

string | null

Serialized cursor for the next page, for example {"ReferenceId":24915663,"ReferenceDateTime":"2025-07-25T09:00:00"}.

prevPageParameter

string | null

List live operations

curl --request GET \
  --url https://gateway-api.guardhousehq.com/api/external/liveops \
  --header 'Authorization: Bearer <token>' \
  --header 'external-gh-apim-sub-key: <api-key>'

import requests

url = "https://gateway-api.guardhousehq.com/api/external/liveops"

headers = {
    "Authorization": "Bearer <token>",
    "external-gh-apim-sub-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'external-gh-apim-sub-key': '<api-key>'}
};

fetch('https://gateway-api.guardhousehq.com/api/external/liveops', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway-api.guardhousehq.com/api/external/liveops",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "external-gh-apim-sub-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway-api.guardhousehq.com/api/external/liveops"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("external-gh-apim-sub-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://gateway-api.guardhousehq.com/api/external/liveops")
  .header("Authorization", "Bearer <token>")
  .header("external-gh-apim-sub-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway-api.guardhousehq.com/api/external/liveops")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["external-gh-apim-sub-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "isSuccess": true,
  "statusMessage": "<string>",
  "status": 123,
  "errorMessages": [
    {}
  ],
  "errorMessagesAsString": "<string>",
  "data": [
    {
      "companyName": "<string>",
      "name": "<string>",
      "siteName": "<string>",
      "customerName": "<string>",
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "timeIn": "2023-11-07T05:31:56Z",
      "timeOut": "2023-11-07T05:31:56Z",
      "status": "CLOCKED IN",
      "inSignatureUrl": "<string>",
      "outSignatureUrl": "<string>",
      "inPhotoUrl": "<string>",
      "outPhotoUrl": "<string>",
      "inLatitude": 123,
      "inLongitude": 123,
      "outLatitude": 123,
      "outLongitude": 123,
      "startTimeTZ": "2023-11-07T05:31:56Z",
      "endTimeTZ": "2023-11-07T05:31:56Z",
      "timeInTZ": "2023-11-07T05:31:56Z",
      "timeOutTZ": "2023-11-07T05:31:56Z",
      "subcontractorName": "<string>",
      "eventID": "<string>",
      "mobile": "<string>",
      "email": "jsmith@example.com",
      "address": "<string>",
      "calledAt": "2023-11-07T05:31:56Z",
      "calledBy": 123,
      "entryTypeID": 123,
      "isClockInOffSite": true,
      "isClockOutOffSite": true,
      "calledByFullName": "<string>",
      "inEnteredByFullName": "<string>",
      "outEnteredByFullName": "<string>",
      "licenses": [
        {}
      ],
      "welfareCheckResponses": [
        {
          "timesheetEntryId": 123,
          "welfareCheckId": 123,
          "dateSent": "2023-11-07T05:31:56Z",
          "hasResponse": true,
          "type": "<string>",
          "parentWelfareCheckId": 123,
          "managerCheck": true,
          "managerEmployee": "<string>",
          "followUps": [
            {}
          ]
        }
      ],
      "welfareCheckNotifResponses": [
        {
          "timesheetEntryId": 123,
          "welfareCheckId": 123,
          "dateSent": "2023-11-07T05:31:56Z",
          "hasResponse": true,
          "type": "<string>",
          "parentWelfareCheckId": 123,
          "managerCheck": true,
          "managerEmployee": "<string>",
          "followUps": [
            {}
          ]
        }
      ],
      "statusText": "<string>",
      "publishedShiftID": 123,
      "sitePositionName": "<string>",
      "shiftId": 123
    }
  ],
  "nextPageParameter": "<string>",
  "prevPageParameter": "<string>"
}

{
  "data": "<unknown>",
  "errors": [
    {
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "meta": {
    "traceId": "<string>",
    "timestampUtc": "2023-11-07T05:31:56Z",
    "nextPageEndpoint": "<string>",
    "prevPageEndpoint": "<string>"
  }
}

{
  "status": {
    "code": 123,
    "errorMessage": "<string>"
  },
  "data": "<unknown>",
  "count": 123,
  "message": "<string>",
  "errors": [
    {
      "code": 100,
      "message": "<string>"
    }
  ]
}

Get started

Endpoints

List live operations

Authorizations

Query Parameters

Response