PunchList

Collection of punch pairs for a specific date or row

punches object[]

List of punch-in/punch-out pairs. (Each pair is a single object here.)

Array [

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

]

PunchList

{
  "punches": [
    {
      "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
      }
    }
  ]
}