> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.xperiencehr.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Hours API

The **Hours API** in XperienceHR provides a seamless interface for exporting employee attendance records, enabling external systems to integrate effortlessly for reporting, payroll, and workforce management.

This API allows businesses to retrieve detailed hourly time entries—including dates, timestamps, and project associations—in XML format. Authentication is enforced via an **API key** generated in the app configuration.

By leveraging the Hours API, organizations can automate attendance tracking, ensure accurate payroll calculations, and gain real-time insights into workforce productivity.

# Overview

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

# Request Parameters

| Parameter | Type | Required | Description |
| ---- |
| attendanceFrom | string | ✅ | Start of the period, formatted as `YYYYMMDDhhmm` (e.g., `202201010000` for Jan 1, 2022 00:00). |
| attendanceTo | string | ✅ | End of the period, formatted as `YYYYMMDDhhmm` (e.g., `202201311159` for Jan 31, 2022 11:59). |
| clientCode | string | ❌ | Code of the client to filter records. Omit to retrieve hours for all clients. |
| apiKey | string | ✅ | Your API key. |
---

# Operations

### Get All Hours for Period

Retrieves attendance records for the specified date range.

###### Endpoint
---

### Get Hours for Period by Client

Retrieves attendance records for the specified date range, filtered by client.

###### Endpoint
---

### 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.