List all time trackers

Returns all time trackers for the current user. The Time Tracker is a real-time time tracking feature that allows users to measure work time while actively working on tasks or projects.

Each tracker can be associated with a specific task or project, includes activity categorization, optional comments, and tracks time through intervals (start/end periods).

Response includes calculated fields:

isRunning: Whether the tracker currently has an active interval
hours: Total tracked time in hours (sum of all intervals plus correction)
autoEnded: Whether any interval was automatically ended at end of day
isOld: Whether the tracker contains intervals from previous days
hoursPadded/minutesPadded: Formatted time strings for display

Also returns lastInteraction timestamp indicating when the user last interacted with any tracker.

GET/account/time-tracker

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200

lastInteractionstring | nullrequired

Timestamp of the last interaction with any tracker (create, update, pause, resume, etc.) in ISO 8601 format (UTC). Used to track user activity. Can be null if no trackers exist.

trackersTimeTrackerResponseDto[]required

Array of all time trackers belonging to the authenticated user, sorted by creation time. Each tracker includes calculated fields like isRunning, hours, and formatted time strings.

Show properties

Array of TimeTrackerResponseDto

activityIdobject | nullrequired

UUID of the activity category (e.g., Development, Testing, Management). Used for categorizing work in reports. Can be null.

autoEndedbooleanrequired

Whether any interval was automatically ended at the end of the day. This happens when a running interval started on a previous day and was not manually stopped.

commentobject | nullrequired

Optional comment or description of the work being tracked. Helps provide context when reviewing time entries later.

correctionnumberrequired

Manual time adjustment in minutes. Positive values add time, negative values subtract time. Useful for correcting tracking errors or adding time that was not tracked. Default is 0.

createdAtstringrequired

Timestamp when the tracker was created, in ISO 8601 format (UTC)

hoursnumberrequired

Total tracked time in hours, calculated from all intervals plus any correction. Minimum value is 0.0166667 (1 minute).

hoursPaddedstringrequired

Hours portion of the tracked time, formatted as a zero-padded string (e.g., "02", "12", "00")

idstringrequired

Unique identifier for the time tracker (UUID)

intervalsTimeTrackerIntervalDto[]required

Array of time intervals that make up the total tracked time. Each interval represents a continuous period of tracking (start to end). If an interval has no end, it is currently active. Intervals are automatically ended at end of day if they span midnight.

Show properties

Array of TimeTrackerIntervalDto

endstringrequired

Interval end time in ISO 8601 format (UTC). For active (running) intervals, this is set to the current time. For completed intervals, this marks when tracking stopped. Intervals that span midnight are automatically ended at end of day.

startstringrequired

Interval start time in ISO 8601 format (UTC). This is when the time tracking period began.

isOldbooleanrequired

Whether the tracker contains intervals from previous days. True if any interval start time is not from today.

isRunningbooleanrequired

Whether the tracker currently has an active (running) interval. True if any interval has no end time, meaning time is being tracked right now.

minutesPaddedstringrequired

Minutes portion of the tracked time, formatted as a zero-padded string (e.g., "05", "30", "59")

projectIdobject | nullrequired

UUID of the project this tracker is associated with. Can be null if tracking general work.

taskIdobject | nullrequired

UUID of the task this tracker is associated with. Only used when timeTrackingType is Task. Can be null for project-level tracking.

timeTrackingTypestringrequired

Type of time tracking: Task (tracking time on a specific task) or Project (tracking time at project level). Determines whether taskId is required.

Allowed:TaskProject

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X GET "https://leadtime.app/api/public/account/time-tracker" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/account/time-tracker", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/account/time-tracker",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "lastInteraction": "2024-01-15T13:00:00Z",
  "trackers": [
    {
      "activityId": "550e8400-e29b-41d4-a716-446655440003",
      "autoEnded": false,
      "comment": "Working on feature implementation",
      "correction": 0,
      "createdAt": "2024-01-15T10:00:00Z",
      "hours": 2.5,
      "hoursPadded": "02",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "intervals": [
        {
          "end": "2024-01-15T11:30:00Z",
          "start": "2024-01-15T10:00:00Z"
        }
      ],
      "isOld": false,
      "isRunning": true,
      "minutesPadded": "30",
      "projectId": "550e8400-e29b-41d4-a716-446655440001",
      "taskId": "550e8400-e29b-41d4-a716-446655440002",
      "timeTrackingType": "Task"
    }
  ]
}