Skip to main content

Punch

A punch-in/punch-out time pair representing a work period. Only applicable to time entry sheets with punch time tracking enabled.

time_instringrequired

Punch-in time in HH:MM format (24-hour)

Example: 08:00
time_in_unix_epochnumber<double>required

Punch-in time as Unix timestamp

Example: 1730894400
time_in_ISO_8601string<date-time>required

Punch-in time in ISO 8601 format

Example: 2025-11-04T08:00:00-06:00
time_in_location object

Location captured at punch-in time (optional)

coords objectrequired

Geographic coordinates

latitudenumber<double>required

Latitude in decimal degrees

Example: 30.0613632
longitudenumber<double>required

Longitude in decimal degrees

Example: -99.1363072
altitudenumber<double>nullable

Altitude in meters above sea level (when available).

Example: null
accuracynumber<float>

Horizontal accuracy in meters. A geofence can have a minimum required accuracy, but different devices may have different capabilities.

Example: 963.78847
notesstring

Additional notes or description for this location. This is only rarely provided / available.

Example:
timestampnumber<double>required

Unix timestamp (milliseconds) when the location was captured

Example: 1762542072875
time_outstringnullable

Punch-out time in HH:MM format (24-hour). Null for open punches (not yet punched out).

Example: 12:00
time_out_unix_epochnumber<double>nullable

Punch-out time as Unix timestamp

Example: 1762279200
time_out_ISO_8601string<date-time>nullable

Punch-out time in ISO 8601 format

Example: 2025-11-04T12:00:00-06:00
time_out_location object

Location captured at punch-out time (optional)

coords objectrequired

Geographic coordinates

latitudenumber<double>required

Latitude in decimal degrees

Example: 30.0613632
longitudenumber<double>required

Longitude in decimal degrees

Example: -99.1363072
altitudenumber<double>nullable

Altitude in meters above sea level (when available).

Example: null
accuracynumber<float>

Horizontal accuracy in meters. A geofence can have a minimum required accuracy, but different devices may have different capabilities.

Example: 963.78847
notesstring

Additional notes or description for this location. This is only rarely provided / available.

Example:
timestampnumber<double>required

Unix timestamp (milliseconds) when the location was captured

Example: 1762542072875
Punch
{
"time_in": "08:00",
"time_in_unix_epoch": 1730894400,
"time_in_ISO_8601": "2025-11-04T08:00:00-06:00",
"time_in_location": {
"coords": {
"latitude": 30.0613632,
"longitude": -99.1363072,
"altitude": null,
"accuracy": 963.78847
},
"notes": "",
"timestamp": 1762542072875
},
"time_out": "12:00",
"time_out_unix_epoch": 1762279200,
"time_out_ISO_8601": "2025-11-04T12:00:00-06:00",
"time_out_location": {
"coords": {
"latitude": 30.0613632,
"longitude": -99.1363072,
"altitude": null,
"accuracy": 963.78847
},
"notes": "",
"timestamp": 1762542072875
}
}