Skip to main content
GET
/
workers
/
{id}
/
time-punches
/
{punch_id}
Get Worker Time Punch
curl --request GET \
  --url https://api.roostedhr.com/api/1_12/workers/{id}/time-punches/{punch_id} \
  --header 'X-API-KEY: <api-key>'
{
  "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
}

Authorizations

X-API-KEY
string
header
required

Path Parameters

id
string
required

Worker ID

punch_id
string
required

Time Punch ID

Response

OK

A time punch record for a worker, including clock type, status, and associated shift details.

id
string

Time punch ID.

Example:

"QNPdD"

p_id
string

Worker ID.

Example:

"3158"

erf_id
string | null

Associated shift assignment ID.

Example:

"2205477"

ern_id
string | null

Associated shift role ID.

Example:

"1442591"

manager_id
string

ID of the manager who processed the punch.

Example:

"3158"

events_roles_placeholders_id
string | null

Associated placeholder ID.

latitude
string | null

GPS latitude of punch location.

longitude
string | null

GPS longitude of punch location.

source
string

Source of the time punch.

Example:

"Manager"

punch_datetime
string

Punch datetime in UTC.

Example:

"2024-05-03 20:00:00"

converted_punch_datetime
string

Punch datetime converted to event timezone.

Example:

"2024-05-03 15:00:00"

status
string

Punch status (e.g., approved, pending, declined).

Example:

"approved"

clock_picture_location
string | null

URL of the clock-in/out photo.

insert_date
string

Record creation datetime.

Example:

"2024-04-30 13:57:28"

override_max_shift_time
string

Whether max shift time override is enabled.

Example:

"N"

original_datetime
string | null

Original punch datetime before any edits.

time_change_request
string | null

Requested time change value.

time_change_request_submitted
string | null

Datetime the time change request was submitted.

client_sign_datetime
string | null

Datetime the client signed off.

delete_requested
string

Whether deletion has been requested.

Example:

"0"

open
string

Whether the punch is open (unpaired).

Example:

"0"

bad_location
string

Whether the punch location was flagged.

Example:

"0"

client_name
string

Associated client name.

Example:

"Test Client #1"

client_invoice_customer_id
string

Client invoice customer ID.

Example:

"0123007"

event_name
string

Associated event name.

Example:

"Hello World"

location_id
string

Location ID.

Example:

"1503"

location
string

Location name.

Example:

"Arrowhead Stadium"

addy_city
string

Location city.

Example:

"Kansas City"

timezone_name
string

Event timezone.

Example:

"America/Chicago"

jobs_id
string

Associated job ID.

Example:

"677421"

custom_event_id
string

Custom event identifier.

areas
string

Associated areas.

client_id
string

Client ID.

Example:

"hAjwQ"

ern_start
string

Shift start datetime.

Example:

"2024-05-03 14:00:00"

ern_date
string

Shift date.

Example:

"2024-05-03 14:00:00"

ern_start_date
string

Shift start date.

Example:

"2024-05-03"

nice_ern_start
string

Formatted shift start time.

Example:

"2:00 PM"

role_title
string

Role title.

Example:

"Bartender"

ern_end
string

Shift end datetime.

Example:

"2024-05-23 00:00:00"

payroll_groups_id
string

Payroll group ID.

Example:

"gDrT7"

payroll_groups_name
string | null

Payroll group name.

rate_cards_id
string | null

Rate card ID.

rate_cards_name
string | null

Rate card name.

signature_datetime
string | null

Manager signature datetime.

signature_name
string | null

Manager signature name.

signature_notes
string | null

Manager signature notes.

signature_location
string | null

Manager signature location URL.

worker_signature_location
string | null

Worker signature location URL.

worker_signature_comments
string | null

Worker signature comments.

worker_signature_datetime
string | null

Worker signature datetime.

worker_signature_missing
boolean

Whether the worker signature is missing.

Example:

true

travel_hours_before
string

Travel hours before shift.

Example:

"0.00"

travel_hours_after
string

Travel hours after shift.

Example:

"0.00"

timezone_data
string

Timezone abbreviation.

Example:

"CDT"

nice_shiftedPunch
string

Formatted punch time with timezone.

Example:

"15:00 CDT May 3rd"

nice_shiftedPunch_ampm
string

Formatted punch time with AM/PM.

Example:

"3:00 pm CDT May 3rd"

punchDate
string

Punch date.

Example:

"2024-05-03"

shiftedPunch
string

Timezone-adjusted punch datetime.

Example:

"2024-05-03 15:00:00"

nicePunch
string

Formatted punch time.

Example:

"3:00 pm"

scheduledHours
integer

Scheduled hours for the shift.

Example:

466

clockType
string

Clock type (IN or OUT).

Example:

"OUT"

in_punch
string

Associated clock-in punch datetime.

Example:

"2024-05-03 10:00:00"

spot_wage
string | null

Spot wage rate.

shift_wage
string | null

Shift wage rate.

personnel_pay_rate
string | null

Personnel pay rate.

client_pay_rate
string | null

Client pay rate.

role_pay_rate
string | null

Role pay rate.

spot_billing_rate
string | null

Spot billing rate.

shift_billing
string | null

Shift billing rate.

personnel_billing_rate
string | null

Personnel billing rate.

client_billing_rate
string | null

Client billing rate.

role_billing_rate
string | null

Role billing rate.

possibleDuplicate
boolean

Whether this punch may be a duplicate.