TimeClock 365 API Guide
Connect your organizational systems directly to TimeClock 365. Pull attendance data, punch records, lunch breaks, and full timesheets — automatically and accurately.
Technical Connection Details
All API calls use a single JSON-RPC endpoint over HTTPS. Every request must include a Bearer token in the Authorization header.
https://live.timeclock365.com/api/v1/json-rpc application/json Authentication
All requests must include a Bearer token in the Authorization header. You can generate and manage your API keys under the Integrations tab in your TimeClock 365 dashboard.
Authorization: Bearer YOUR_API_TOKEN Content-Type: application/json
What You Can Do with the API
Punch In/Out Records
Pull clock-in and clock-out events per employee, per day, or per date range.
Lunch Breaks
Retrieve break start and end times, total break duration, and break counts.
Timesheets
Access full daily and monthly timesheets including worked hours, overtime, and absences.
Extended Attendance
Get detailed attendance data with location, attendance type, and notes.
Employee Data
Sync employee profiles, roles, departments, and contract information.
Leave & Absences
Retrieve leave requests, balances, and approval status per employee.
Endpoints
All requests are POST to the base URL with the method name in the JSON body.
Authentication
Generate your API token from the dashboard under Settings → Integrations → API Keys.
POST https://live.timeclock365.com/api/v1/json-rpc
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
{
"method": "getPunchRecords",
"params": {
"from": "2024-01-01",
"to": "2024-01-31"
}
} Punch In/Out Records
Retrieve all clock-in and clock-out events for a date range.
method: "getPunchRecords" | Parameter | Type | Description |
|---|---|---|
| from | string | Start date (YYYY-MM-DD) |
| to | string | End date (YYYY-MM-DD) |
| employeeId | integer | Optional — filter by employee |
Lunch Breaks
Retrieve break start/end times and total duration per employee.
method: "getBreakRecords" | Parameter | Type | Description |
|---|---|---|
| from | string | Start date (YYYY-MM-DD) |
| to | string | End date (YYYY-MM-DD) |
| employeeId | integer | Optional — filter by employee |
Timesheets
Get full timesheet data including worked hours, overtime, and absences.
method: "getTimesheets" | Parameter | Type | Description |
|---|---|---|
| month | integer | Month number (1–12) |
| year | integer | Four-digit year |
| employeeId | integer | Optional — filter by employee |
Extended Attendance
Detailed attendance data with location, attendance type, and notes.
method: "getExtendedAttendance" | Parameter | Type | Description |
|---|---|---|
| from | string | Start date (YYYY-MM-DD) |
| to | string | End date (YYYY-MM-DD) |
| includeLocation | boolean | Include GPS coordinates |
Ready to Integrate?
API access is available on Business and Enterprise plans.