Skip to main content
GET
/
workers
/
{id}
/
time-punches
Get Worker Time Punches
curl --request GET \
  --url https://api.roostedhr.com/api/1_12/workers/{id}/time-punches \
  --header 'X-API-KEY: <api-key>'
{
  "time_punches": [
    {
      "id": "QNPdD",
      "p_id": "3158",
      "erf_id": "2205477",
      "ern_id": "1442591",
      "manager_id": "3158",
      "events_roles_placeholders_id": "<string>",
      "latitude": "<string>",
      "longitude": "<string>",
      "source": "Manager",
      "punch_datetime": "2024-05-03 20:00:00",
      "converted_punch_datetime": "2024-05-03 15:00:00",
      "status": "approved",
      "clock_picture_location": "<string>",
      "insert_date": "2024-04-30 13:57:28",
      "override_max_shift_time": "N",
      "original_datetime": "<string>",
      "time_change_request": "<string>",
      "time_change_request_submitted": "<string>",
      "client_sign_datetime": "<string>",
      "delete_requested": "0",
      "open": "0",
      "bad_location": "0",
      "client_name": "Test Client #1",
      "client_invoice_customer_id": "0123007",
      "event_name": "Hello World",
      "location_id": "1503",
      "location": "Arrowhead Stadium",
      "addy_city": "Kansas City",
      "timezone_name": "America/Chicago",
      "jobs_id": "677421",
      "custom_event_id": "<string>",
      "areas": "<string>",
      "client_id": "hAjwQ",
      "ern_start": "2024-05-03 14:00:00",
      "ern_date": "2024-05-03 14:00:00",
      "ern_start_date": "2024-05-03",
      "nice_ern_start": "2:00 PM",
      "role_title": "Bartender",
      "ern_end": "2024-05-23 00:00:00",
      "payroll_groups_id": "gDrT7",
      "payroll_groups_name": "<string>",
      "rate_cards_id": "<string>",
      "rate_cards_name": "<string>",
      "signature_datetime": "<string>",
      "signature_name": "<string>",
      "signature_notes": "<string>",
      "signature_location": "<string>",
      "worker_signature_location": "<string>",
      "worker_signature_comments": "<string>",
      "worker_signature_datetime": "<string>",
      "worker_signature_missing": true,
      "travel_hours_before": "0.00",
      "travel_hours_after": "0.00",
      "timezone_data": "CDT",
      "nice_shiftedPunch": "15:00 CDT May 3rd",
      "nice_shiftedPunch_ampm": "3:00 pm CDT May 3rd",
      "punchDate": "2024-05-03",
      "shiftedPunch": "2024-05-03 15:00:00",
      "nicePunch": "3:00 pm",
      "scheduledHours": 466,
      "clockType": "OUT",
      "in_punch": "2024-05-03 10:00:00",
      "spot_wage": "<string>",
      "shift_wage": "<string>",
      "personnel_pay_rate": "<string>",
      "client_pay_rate": "<string>",
      "role_pay_rate": "<string>",
      "spot_billing_rate": "<string>",
      "shift_billing": "<string>",
      "personnel_billing_rate": "<string>",
      "client_billing_rate": "<string>",
      "role_billing_rate": "<string>",
      "possibleDuplicate": true
    }
  ],
  "total": 32
}

Documentation Index

Fetch the complete documentation index at: https://docs.roostedhr.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint supports pagination via items_per_page and page query parameters.
Use the date parameter to filter punches for a specific date. When date is provided, it takes priority over start_date and end_date. Use shift_id to filter punches for a specific shift assignment.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
id
string
required

Worker ID

Query Parameters

​
date
string<date>

Filter punches for a specific date. Takes priority over start_date and end_date when provided.

Example:

"2026-03-17"

​
start_date
string<date>

Filter punches on or after this date. Ignored if date is provided.

Example:

"2026-01-01"

​
end_date
string<date>

Filter punches on or before this date. Ignored if date is provided.

Example:

"2026-12-31"

​
shift_id
string

Filter punches for a specific shift assignment.

​
items_per_page
integer

Number of items per page.

Required range: 1 <= x <= 100
​
page
integer

Page number.

Required range: x >= 1

Response

OK

​
time_punches
TimePunch · object[]

List of worker time punches.

​
total
integer

Total number of time punches matching the filter criteria.

Example:

32