API reference
Timesheets
10 endpoints. Click one to see its parameters, fields and an example. Code samples use the region you pick.
GET/v1/pay-periods/currentList current
List current
Query parameters
| Name | Type | Description |
|---|---|---|
date | string |
Example
curl "https://ca-api.clocklap.com/v1/pay-periods/current" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200
GET/v1/timesheetsPeriod grid: one row per person
Period grid: one row per person
Query parameters
| Name | Type | Description |
|---|---|---|
date | string | |
location_id | string | |
search | string |
Example
curl "https://ca-api.clocklap.com/v1/timesheets" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200
GET/v1/timesheets/{user_id}Get one timesheet
Get one timesheet
Path parameters
| Name | Type | Description |
|---|---|---|
user_idrequired | string |
Query parameters
| Name | Type | Description |
|---|---|---|
date | string |
Example
curl "https://ca-api.clocklap.com/v1/timesheets/{user_id}" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200
POST/v1/timesheets/{user_id}/approveApprove
Approve
Path parameters
| Name | Type | Description |
|---|---|---|
user_idrequired | string |
Body (JSON)
| Name | Type | Description |
|---|---|---|
date | string |
Example
curl -X POST "https://ca-api.clocklap.com/v1/timesheets/{user_id}/approve" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-26"}'Responses
200
POST/v1/timesheets/{user_id}/lockLock
Lock
Path parameters
| Name | Type | Description |
|---|---|---|
user_idrequired | string |
Body (JSON)
| Name | Type | Description |
|---|---|---|
date | string |
Example
curl -X POST "https://ca-api.clocklap.com/v1/timesheets/{user_id}/lock" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-26"}'Responses
200
POST/v1/timesheets/{user_id}/reopenReopen
Reopen
Path parameters
| Name | Type | Description |
|---|---|---|
user_idrequired | string |
Body (JSON)
| Name | Type | Description |
|---|---|---|
date | string |
Example
curl -X POST "https://ca-api.clocklap.com/v1/timesheets/{user_id}/reopen" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-26"}'Responses
200
POST/v1/timesheets/{user_id}/submitSubmit
Submit
Path parameters
| Name | Type | Description |
|---|---|---|
user_idrequired | string |
Body (JSON)
| Name | Type | Description |
|---|---|---|
date | string |
Example
curl -X POST "https://ca-api.clocklap.com/v1/timesheets/{user_id}/submit" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-26"}'Responses
200
POST/v1/timesheets/{user_id}/unlockUnlock
Unlock
Path parameters
| Name | Type | Description |
|---|---|---|
user_idrequired | string |
Body (JSON)
| Name | Type | Description |
|---|---|---|
date | string |
Example
curl -X POST "https://ca-api.clocklap.com/v1/timesheets/{user_id}/unlock" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-26"}'Responses
200
POST/v1/timesheets/bulkApprove or lock everyone (or a list) for a period
Approve or lock everyone (or a list) for a period
Body (JSON)
| Name | Type | Description |
|---|---|---|
actionrequired | "approve" | "lock" | |
date | string | |
user_ids | array of string | |
location_id | string | Approve only entries at this location (and under it); a timesheet becomes approved once all its entries are |
Example
curl -X POST "https://ca-api.clocklap.com/v1/timesheets/bulk" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"action":"approve","date":"2026-10-26","user_ids":["string"],"location_id":"loc_01J…"}'Responses
200
GET/v1/timesheets/exportCSV export for payroll
CSV export for payroll
Query parameters
| Name | Type | Description |
|---|---|---|
date | string | |
format | "summary" | "detail" | "adp" | "quickbooks" | Default "summary" |
location_id | string |
Example
curl "https://ca-api.clocklap.com/v1/timesheets/export" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200