Get single time tracker

Returns a specific time tracker by ID with all calculated fields. The tracker must belong to the authenticated user.

Calculated fields include running status, total hours (from intervals and correction), formatted time strings, and flags for auto-ended intervals or old trackers.

GET/account/time-tracker/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Responses

200

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

404Tracker not found or does not belong to user

Request

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

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

import requests

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

Response

{
  "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"
}