Welcome to the TimeClock 365 API Guide
Our API interface is designed to allow companies, clients, and developers to connect their organizational systems directly to TimeClock 365. Through this interface, you can automatically pull attendance data, punch in/out records, lunch breaks, and full timesheets in a customized and accurate manner.
Technical Connection Details:
Base URL (HTTPS)
https://live.timeclock365.com/api/v1/json-rpc HTTP Method POST
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.
Headers Example
Content-Type: application/json Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sessions
Punch In/Out Records (Sessions)
Retrieve a list of employee attendance records within a specific date range.
Request Example
{ "jsonrpc": "2.0", "method": "sessions", "params": { "startDate": "2025-10-08", "endDate": "2025-10-15" }, "id": 121 }Response Example
{ "jsonrpc": "2.0", "id": 121, "result": [ { "employeeNumber": 1265, "email": "email@mail.com", "sessions": [ { "startDate": "2024-10-09 08:12:34", "endDate": "2024-10-09 17:18:34", "timezone": "Asia/Jerusalem", "locationType": "office", "startSourceType": "web", "endSourceType": "phone" }, { "startDate": "2024-10-10 08:12:34", "endDate": "2024-10-10 17:18:34", "timezone": "Asia/Jerusalem", "locationType": "office", "startSourceType": "web", "endSourceType": "phone" } ] }, { "employeeNumber": 1267, "email": "example@mail.com", "sessions": [ { "startDate": "2024-10-09 08:12:34", "endDate": "2024-10-09 17:18:34", "timezone": "Asia/Jerusalem", "locationType": "office", "startSourceType": "web", "endSourceType": "phone" }, { "startDate": "2024-10-10 08:12:34", "endDate": "2024-10-10 17:18:34", "timezone": "Asia/Jerusalem", "locationType": "office", "startSourceType": "web", "endSourceType": "phone" } ] } ] } lunches
Lunch Breaks (Lunches)
Fetch lunch break records for employees during the specified period.
Request Example
{ "jsonrpc": "2.0", "method": "lunches", "params": { "startDate": "2025-10-08", "endDate": "2025-10-15" }, "id": 122 }Response Example
{ "jsonrpc": "2.0", "id": 122, "result": [ { "employeeNumber": 1265, "email": "email@mail.com", "sessions": [ { "startDate": "2024-10-09 12:12:34", "endDate": "2024-10-09 12:48:34", "timezone": "Asia/Jerusalem", "startSourceType": "web", "endSourceType": "phone" }, { "startDate": "2024-10-10 12:12:34", "endDate": "2024-10-10 12:51:34", "timezone": "Asia/Jerusalem", "startSourceType": "web", "endSourceType": "phone" } ] }, { "employeeNumber": 1267, "email": "example@mail.com", "sessions": [ { "startDate": "2024-10-09 12:12:34", "endDate": "2024-10-09 13:10:34", "timezone": "Asia/Jerusalem", "startSourceType": "web", "endSourceType": "phone" }, { "startDate": "2024-10-10 12:12:34", "endDate": "2024-10-10 12:28:34", "timezone": "Asia/Jerusalem", "startSourceType": "web", "endSourceType": "phone" } ] } ] } timesheet
Full Timesheets
A comprehensive report including punch in/out records, lunch breaks, and individual work logs (tasks) mapped to specific attendance sessions.
Request Example
{ "jsonrpc": "2.0", "method": "timesheet", "params": { "startDate": "2025-10-08", "endDate": "2025-10-15" }, "id": 123 }Response Example
{ "jsonrpc": "2.0", "id": 123, "result": [ { "employeeNumber": 1265, "email": "email@mail.com", "sessions": [ { "startDate": "2024-10-09 08:12:34", "endDate": "2024-10-09 17:18:34", "timezone": "Asia/Jerusalem", "locationType": "office", "startSourceType": "web", "endSourceType": "phone", "lunches": [ { "startDate": "2024-10-09 12:12:34", "endDate": "2024-10-09 12:48:34", "startSourceType": "web", "endSourceType": "phone" } ], "workLogs": [ { "name": "task", "externalId": "DR-4258", "startDate": "2024-10-09 08:15:34", "endDate": "2024-10-09 12:10:34", "startSourceType": "web", "endSourceType": "phone" }, { "name": "task 1", "externalId": "DR-4259", "startDate": "2024-10-09 12:55:34", "endDate": "2024-10-09 17:10:34", "startSourceType": "web", "endSourceType": "phone" } ] } ] } ] } extended-sessions
Extended Attendance Records
Retrieve detailed attendance data including employee metadata such as total time worked, gender, birthday, and group memberships.
Request Example
{ "jsonrpc": "2.0", "method": "extended-sessions", "params": { "startDate": "2025-01-24", "endDate": "2025-01-24" }, "id": 124 }Response Example
{ "jsonrpc": "2.0", "result": [ { "id": 21814, "employeeNumber": "31394", "email": "s7654321@mail.ru", "passport": "Elena21814", "groups": [], "workStartedAt": "2010-01-03", "workEndedAt": null, "birthday": "1990-12-13", "gender": "female", "totalWorkedSeconds": 10956, "totalLeaveSeconds": 0, "expectedSeconds": 0, "sessions": [ { "startDate": "2025-01-24 12:35:50", "startDateSentAt": "2025-01-24 12:35:50", "startNote": null, "endDate": "2025-01-24 15:38:12", "endDateSentAt": "2025-01-24 15:38:12", "endNote": null, "duration": 10942, "timezone": "Asia\/Jerusalem", "locationType": "office", "startSourceType": "web", "endSourceType": "web", "isAbsence": false, "absenceName": null, "absenceNote": null, "absenceApprovedDate": null, "absenceApprovedManager": null, "absenceCodeDays": null, "absenceCodeHors": null } ] } ], "id": 124 }