---
title: "Get time activities"
method: GET
path: "/time-clock/v1/time-clocks/{timeClockId}/time-activities"
tags: ["Time Clock:v1:TimeClocks:TimeClock:TimeActivities"]
---

# Get time activities

`GET /time-clock/v1/time-clocks/{timeClockId}/time-activities`

Retrieve a list of time activities in under a specified time clock.
Time activities include shift and/or manual breaks

## Path parameters

- `timeClockId` integer, required — The unique identifier of the time clock

## Query parameters

- `startDate` string, required — The start time to filter by in ISO 8601 format (YYYY-MM-DD)
- `endDate` string, required — The end time to filter by in ISO 8601 format (YYYY-MM-DD)
- `userIds` integer[] — Filter time activities by a list of user IDs. Users who are no longer assigned to the specified time clock cannot be retrieved with this filter.
- `jobIds` string[] — The job IDs of shifts
- `manualBreakIds` string[] — The manual break IDs of manual breaks
- `policyTypeIds` string[] — The policy type IDs of time offs
- `activityTypes` TimeActivityType[] — The time activity types: shift, manual_break or time_off

## Response `200`

Successful Response

- APIResponseTimeActivitiesGetResponse
  - `requestId` string
  - `data` TimeActivitiesGetResponse, required
    - `timeActivitiesByUsers` UserTimeActivity[], required — The time activities
      - `userId` integer, required — The ID of the user
      - `shifts` ShiftActivityResponse[], required — The shifts
        - `id` string, required — The unique identifier of the time clock
        - `managerNote` string — The manager note providing additional details
        - `employeeNote` string — The employee note providing additional details
        - `start` TimeActivityTimePointResponse, required
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
          - `locationData` GpsData
            - `address` string — The address associated with the GPS data.
            - `longitude` number — The longitude coordinate.
            - `latitude` number — The latitude coordinate.
          - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
          - `source` PunchSourceResponse
            - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
            - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
            - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
            - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
        - `end` TimeActivityTimePointResponse
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
          - `locationData` GpsData
            - `address` string — The address associated with the GPS data.
            - `longitude` number — The longitude coordinate.
            - `latitude` number — The latitude coordinate.
          - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
          - `source` PunchSourceResponse
            - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
            - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
            - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
            - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
        - `createdAt` integer — The creation time of the time activity
        - `modifiedAt` integer — The last modification time of the time activity
        - `jobId` string — The ID of the job
        - `subJobId` string — The ID of the sub job
        - `schedulerShiftId` string — The unique identifier of the shift from the schedule, if it exists.
        - `shiftAttachments` GeneralActivityShiftAttachmentResponse[] — The shift attachments
          - `shiftAttachmentId` string, required — The ID of the shift attachment
          - `attachment` GeneralActivityShiftAttachmentValueResponse, required
            - `itemId` string — The ID of the dropdown list item
            - `freeText` string — The value of the shift attachment of type free text
            - `number` number — The value of the shift attachment of type number
            - `fileName` string — The name of the file in a shift attachment of type file
            - `fileUrl` string — The URL of the file in a shift attachment of type file
            - `files` ActivityFileResponse[] — The value of the shift attachment of type files
              - …
            - `images` string[] — The value of the shift attachment of type images
            - `image` string — The value of the shift attachment of type signature
        - `isAutoClockOut` boolean — Indicates whether the user was auto clocked out from the shift
      - `manualBreaks` ManualBreakActivityResponse[], required — The manual breaks
        - `id` string, required — The unique identifier of the time clock
        - `managerNote` string — The manager note providing additional details
        - `employeeNote` string — The employee note providing additional details
        - `start` TimeActivityTimePointResponse, required
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
          - `locationData` GpsData
            - `address` string — The address associated with the GPS data.
            - `longitude` number — The longitude coordinate.
            - `latitude` number — The latitude coordinate.
          - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
          - `source` PunchSourceResponse
            - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
            - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
            - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
            - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
        - `end` TimeActivityTimePointResponse
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
          - `locationData` GpsData
            - `address` string — The address associated with the GPS data.
            - `longitude` number — The longitude coordinate.
            - `latitude` number — The latitude coordinate.
          - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
          - `source` PunchSourceResponse
            - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
            - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
            - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
            - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
        - `createdAt` integer — The creation time of the time activity
        - `modifiedAt` integer — The last modification time of the time activity
        - `manualBreakId` string, required — The ID of the manual break
        - `isAutoClockOut` boolean — Indicates whether the user was auto clocked out from the shift
      - `timeOffs` TimeOffActivityResponse[] — The time offs
        - `id` string, required — The unique identifier of the time clock
        - `managerNote` string — The manager note providing additional details
        - `employeeNote` string — The employee note providing additional details
        - `start` TimeActivityTimePointResponse, required
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
          - `locationData` GpsData
            - `address` string — The address associated with the GPS data.
            - `longitude` number — The longitude coordinate.
            - `latitude` number — The latitude coordinate.
          - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
          - `source` PunchSourceResponse
            - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
            - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
            - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
            - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
        - `end` TimeActivityTimePointResponse
          - `timestamp` integer, required — The timestamp in Unix format (in seconds)
          - `timezone` string, required — The timezone in Tz format (e.g. America/New_York)
          - `locationData` GpsData
            - `address` string — The address associated with the GPS data.
            - `longitude` number — The longitude coordinate.
            - `latitude` number — The latitude coordinate.
          - `geofenceId` string — The ID of the geofence the user was inside when this punch was recorded. None if the punch was outside any configured geofence.
          - `source` PunchSourceResponse
            - `id` string — Unique identifier of the source (for NFC or geofence-based sources)
            - `type` 'autoClockOut' | 'nfc' | 'mobile' | 'pc' | 'kiosk' | 'api' | 'admin', required — An enumeration.
            - `mode` 'dailyLimit' | 'hourLimit' | 'schedulerShiftEnded' | 'geofenceExit' | 'disabledGps' | 'disabledGpsPermission' — An enumeration.
            - `name` string — Human-readable name of the source (for NFC or geofence-based sources)
        - `createdAt` integer — The creation time of the time activity
        - `modifiedAt` integer — The last modification time of the time activity
        - `policyTypeId` string, required — The ID of the policy type
        - `duration` TimeOffDurationResponse, required
          - `value` number, required — The value of the duration
          - `units` 'hours' | 'days', required — An enumeration.
        - `isAllDay` boolean, required — Indicates whether the time off is all day

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/connecteam/apis/connecteam-api-documentation.md) · [All operations](https://skmtc.net/connecteam/apis/connecteam-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/connecteam/connecteam-api-documentation/revisions/d8f7f302222e/schema)