The Time Records API in XperienceHR provides an interface for retrieving employee time records, allowing seamless integration with external systems for payroll, reporting, and attendance tracking.

This API enables businesses to access detailed records of employee working hours, including timestamps, projects, and work statuses. It supports XML & JSON format for structured data exchange and requires authentication via an API key.

By integrating the Time Records API, organizations can streamline workforce tracking, ensuring accurate work hour calculations and efficient payroll processing.

Overview

API Type: REST
Supported Formats: XML
API Key: Generated in the app configuration
Method: GET

Time Records

Get All Time Records

Fetches the complete time records of employees within the system.

Endpoint

Get Time Records Filtered by Parameters

Parameter	Type	Required	Description
timeFrom	string	✅	Start date of the time record range (format: yyyy-mm-dd, e.g., 1990-01-01).
timeTo	string	✅	End date of the time record range (format: yyyy-mm-dd, e.g., 1990-01-01).
username	string	❌	User login name.
locked	boolean	❌	Indicates if the time record is locked.
includeAbsence	boolean	❌	Includes absence time records.
processId	string	❌	If the date range between timeFrom and timeTo exceeds 35 days, the response includes a processId to use as a parameter for additional results.
employeeID	string	❌	User ID (modifiable by admin).
projectName	string	❌	Name of the project.
projectCode	string	❌	Code of the project.
activityName	string	❌	Name of the activity.
activityCode	string	❌	Code of the activity.
costCenterName	string	❌	Name of the cost center.
costCenterCode	string	❌	Code of the cost center.
absenceName	string	❌	Name of the time-off type.
absenceCode	string	❌	Code of the time-off type.
status	string	❌	Status of the time record, either OPEN or APPROVED. (REJECTED status is not included in queries by default)
isBillable	boolean	❌	Indicates if the time record is billable.
absenceOnly	boolean	❌	Retrieves only time records with absences.
lastModifiedAfter	string	❌	Retrieves records modified after the specified date (format: yyyy-mm-dd).

To use the parameters absenceName, absenceCode, or absenceOnly, the includeAbsence parameter must be set to true.

Endpoint

status: This field is relevant if project timesheet approvals are used.

locked: This field only appears when a time record is locked.

HTTP Response Codes

2XX Success - Operation completed successfully.
4XX Client Error - Likely an issue with the request, such as incorrect parameters or insufficient permissions. Returns an error message in text or XML format.
5XX Server Error - Indicates a server issue. Report this error if encountered.

Updated on: 16/03/2025