List my time tracking items by date

Lists the calling user's own time registrations (project time and absence) between two dates, enriched for display.

Returns the caller's registrations with Date between startDate and endDate (both inclusive), each as a TimeTrackingItemRead: the registration plus its customer, project, task or absence code, allocation hours and approval / invoicing state. Always the CALLER's registrations — there is no employee parameter, so it cannot be used to read other employees' time. Paged ($page / $pagesize); each page is selected in creation order and then sorted by StartTime.

Use it to:

Render a day / period timesheet in a time-tracking client
Let an employee review what they registered before submitting

Not for:

Other employees' time or reporting across employees → Reporting API / time registration reports
Grouped week with norm time → GET /v1/time-tracking-item/get-weekly-registrations

Behaviour:

Idempotent.
Safe to retry.
Duplicates: n/a (read)
Changes are visible to the next read immediately.

Next: GET /v1/time-tracking-item/{timeRegistrationID}, PUT /v1/time-registration, POST /v1/time-tracker/task/start-time-tracker

See also: GET /v1/time-tracking-item/get-by-date-order-by-recent-registration, GET /v1/time-tracking-item/get-weekly-registrations

Not yet documented: examples; request → query params.

curl -X GET "https://app3.timelog.com/your-account/api/v1/time-tracking-item/get-by-date?startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$page=1&$pagesize=10" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests
import json

url = "https://app3.timelog.com/your-account/api/v1/time-tracking-item/get-by-date?startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$page=1&$pagesize=10"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://app3.timelog.com/your-account/api/v1/time-tracking-item/get-by-date?startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$page=1&$pagesize=10", {
  method: "GET",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("GET", "https://app3.timelog.com/your-account/api/v1/time-tracking-item/get-by-date?startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$page=1&$pagesize=10", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://app3.timelog.com/your-account/api/v1/time-tracking-item/get-by-date?startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$page=1&$pagesize=10')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts response.body

{
  "Properties": {
    "TotalRecord": "example_string",
    "TotalPage": "example_string",
    "PageNumber": "example_string"
  },
  "Entities": [
    {
      "Properties": {
        "CustomerID": "null",
        "CustomerName": "John Doe",
        "CustomerNo": "example_string",
        "ProjectID": "null",
        "ProjectName": "John Doe",
        "ProjectNo": "example_string",
        "TaskID": "null",
        "TaskName": "John Doe",
        "TaskFullName": "John Doe",
        "IsFixedPrice": "null",
        "TaskNo": "example_string",
        "TaskIsActive": "null",
        "AbsenceCodeID": "null",
        "AbsenceName": "John Doe",
        "AbsenceCode": "example_string",
        "AbsenceIsActive": "null",
        "AdditionalTextIsRequired": true,
        "DefaultBillable": true,
        "IsETCProject": true,
        "ShowBillable": true,
        "AllocatedHour": "null",
        "TimeRegistrationID": 123,
        "EntityID": 123,
        "EntityType": 42,
        "UserID": 123,
        "Created": "2024-12-25T10:00:00Z",
        "CreatedBy": 42,
        "LastModified": "2024-12-25T10:00:00Z",
        "LastModifiedBy": 42,
        "IsBillable": true,
        "Status": true,
        "Date": "2024-12-25T10:00:00Z",
        "MonthlyPeriod": "example_string",
        "Comment": "example_string",
        "Hours": 3.14,
        "AdditionalTextField": "example_string",
        "InvoiceStatus": true,
        "TimeRegistrationApprovalStatus": 42,
        "TimeTrackingFormat": 42,
        "Minutes": 42,
        "BillableHours": 3.14,
        "BillableMinutes": 42,
        "IsFavourite": true,
        "StartTime": "null",
        "EndTime": "null",
        "IsTimestampOverlapping": true
      },
      "Links": [
        {
          "Href": "example_string",
          "Rel": "example_string"
        }
      ],
      "Actions": [
        {}
      ]
    }
  ],
  "Links": [
    {
      "Href": "example_string",
      "Rel": "example_string"
    }
  ]
}

GET

/v1/time-tracking-item/get-by-date

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp). The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user. > Not yet documented: how to obtain a token. > Not yet documented: token lifetime.

query

startDatestring

Required

First day (inclusive). Omitting it → 404 (no action matched). Filters on TimeTrackingItemRead.Date (gte).

Format: date-time

query

endDatestring

Required

Last day (inclusive). Not checked against startDate: endDate < startDate returns an empty list. Filters on TimeTrackingItemRead.Date (lte).

Format: date-time

Page number.

Page size.

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token. OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).

The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.