--- title: Live Ops Open API description: Live Ops Open API --- [Skip to content](https://university.guardhousehq.com/live-ops-open-api#main-content) English Show submenu for translations [![Text\_gradient gold-1-2](https://university.guardhousehq.com/hs-fs/hubfs/Text_gradient%20gold-1-2.png?width=225&height=30&name=Text_gradient%20gold-1-2.png)](https://university.guardhousehq.com/?hsLang=en) Open main navigation Close main navigation - English Show submenu for translations - [Contact Support](mailto:support@guardhousehq.com) [Contact Support](mailto:support@guardhousehq.com) How can we help you? - There are no suggestions because the search field is empty. 1. [Guardhouse Knowledge Base](https://university.guardhousehq.com/?hsLang=en) 2. [API Integration](https://university.guardhousehq.com/api-integration?hsLang=en) # Live Ops Open API  Live Ops Open API Access requirements Access is controlled. The requesting system needs an API key issued specifically for live operations, **a key issued for another purpose (such as timesheets) won't work here.** Authentication happens in two steps 1. The system presents its API key. 2. Guardhouse issues a short-lived access token. That token is used to request the data. List Live Operations This lets another system pull live operational data out of Guardhouse, shift and employee activity as it's happening, rather than historical timesheets. A monitoring dashboard or client system can request this data directly instead of checking the app manually. **Every request also requires a subscription key, issued by Guardhouse Support.** ### Date range Start and end dates are optional. If neither is provided, Guardhouse defaults to a **34-hour window** centred on the current time, from 17 hours before now to 17 hours after now. ### Filtering options **➡️Site:** by name or ID **➡️Customer:** by name or ID **➡️Employee:** by full name **➡️Subcontractor**: by name **➡️Status:** for example, Clocked In **➡️Search text:** free-text search ### Batching Results come back in batches (**100 by default**). Each batch includes a reference point so the next or previous batch can be requested without starting over.   ### Data returned per record ➡️Company, site, customer, and subcontractor names ➡️Employee name, mobile number, email, and address ➡️Scheduled start and end time, and actual clock-in and clock-out time ➡️Clock-in and clock-out location (latitude and longitude), and whether either was off-site ➡️Signature and photo capture at clock-in and clock-out ➡️Current status (for example, Clocked In) ➡️Licence details ➡️Welfare check responses and notifications ➡️Who logged the entry, and when ➡️Site position and shift references ### Error handling **➡️Unauthorised:** the access token is missing or invalid. **➡️Forbidden**: the token doesn't carry the required key type, or the request falls outside the API key's permissions. Source: [https://guardhouse.mintlify.app/api-reference/live-operations/list-live-operations](https://guardhouse.mintlify.app/api-reference/live-operations/list-live-operations)     - [Dashboard](https://university.guardhousehq.com/dashboard?hsLang=en) - [Schedule](https://university.guardhousehq.com/schedule?hsLang=en) - [Timesheets](https://university.guardhousehq.com/timesheets?hsLang=en#main-content) - [Timesheets v1](https://university.guardhousehq.com/timesheets?hsLang=en#timesheets-v1) - [Timesheets v2](https://university.guardhousehq.com/timesheets?hsLang=en#timesheets-v2) - [Paysheets](https://university.guardhousehq.com/paysheets?hsLang=en#main-content) - [Payroll Extracts](https://university.guardhousehq.com/paysheets?hsLang=en#payroll-extracts) - [allowance/s](https://university.guardhousehq.com/paysheets?hsLang=en#allowance-s) - [Invoicing](https://university.guardhousehq.com/invoicing?hsLang=en#main-content) - [New Zealand](https://university.guardhousehq.com/invoicing?hsLang=en#new-zealand) - [Reports](https://university.guardhousehq.com/reports?hsLang=en#main-content) - [Staff Reports](https://university.guardhousehq.com/reports?hsLang=en#staff-reports) - [Incidents](https://university.guardhousehq.com/incidents?hsLang=en) - [Company Settings](https://university.guardhousehq.com/company-settings?hsLang=en#main-content) - [Timeclock](https://university.guardhousehq.com/company-settings?hsLang=en#timeclock) - [Onboarding](https://university.guardhousehq.com/company-settings?hsLang=en#onboarding) - [Integrations](https://university.guardhousehq.com/company-settings?hsLang=en#integrations) - [Payroll](https://university.guardhousehq.com/payroll?hsLang=en#main-content) - [Allowances & Deductions](https://university.guardhousehq.com/payroll?hsLang=en#allowances-deductions) - [Customers](https://university.guardhousehq.com/customers?hsLang=en#main-content) - [Customer Portal](https://university.guardhousehq.com/customers?hsLang=en#customer-portal) - [Sites](https://university.guardhousehq.com/sites?hsLang=en) - [Tours & Patrols](https://university.guardhousehq.com/tours-patrols?hsLang=en) - [Staff](https://university.guardhousehq.com/staff?hsLang=en) - [Subcontractor](https://university.guardhousehq.com/subcontractor?hsLang=en#main-content) - [Subcontactor Sharing](https://university.guardhousehq.com/subcontractor?hsLang=en#subcontactor-sharing) - [Frequently Asked Questions](https://university.guardhousehq.com/frequently-asked-questions?hsLang=en) - [Getting Started](https://university.guardhousehq.com/getting-started?hsLang=en) - [Holidays](https://university.guardhousehq.com/holidays?hsLang=en) - [Documents](https://university.guardhousehq.com/documents?hsLang=en) - [Leave / Unavailability](https://university.guardhousehq.com/leave-unavailability?hsLang=en) - [Guardhouse Support Topics](https://university.guardhousehq.com/guardhouse-support-topics?hsLang=en) - [Invoicing Integrations](https://university.guardhousehq.com/invoicing-integrations?hsLang=en) - [Payroll Integrations](https://university.guardhousehq.com/payroll-integrations?hsLang=en) - [Product Updates](https://university.guardhousehq.com/product-updates?hsLang=en) - [Release Notes](https://university.guardhousehq.com/release-notes?hsLang=en) - [Webinars](https://university.guardhousehq.com/webinars?hsLang=en) - [Xero](https://university.guardhousehq.com/xero?hsLang=en) - [Guides for Guards](https://university.guardhousehq.com/guides-for-guards?hsLang=en) - [API Integration](https://university.guardhousehq.com/api-integration?hsLang=en) - [Integrations](https://university.guardhousehq.com/integrations?hsLang=en) - [Tablet Clock-in/Clock-out](https://university.guardhousehq.com/tablet-clock-in-clock-out?hsLang=en) [![Text\_gradient gold-1-2](https://university.guardhousehq.com/hs-fs/hubfs/Text_gradient%20gold-1-2.png?width=150&height=20&name=Text_gradient%20gold-1-2.png "Text_gradient gold-1-2")](https://guardhousehq.com) [mailto:support@guardhousehq.com](mailto:support@guardhousehq.com) Copyright © 2025, Guardhouse