[New] Filter time tracking entries by date range

English Forum Developers & API Changelog
1

Summary

We’re adding two new optional query parameters ( entered_on_start_date and entered_on_end_date) to the GET /time_tracking_entries endpoint. These parameters let you filter time tracking entries by the entered_on date field, so you can retrieve entries within a specific date range without client-side filtering.

This is a non-breaking change. The new parameters are optional, and existing requests will continue to work without modification.

Who is affected

This enhancement is relevant to developers who use the GET /time_tracking_entries endpoint and need to query entries for specific time periods. Common use cases include:

  • Generating monthly or weekly time reports for a project or portfolio
  • Building billing or invoicing integrations that need entries for a given billing cycle
  • Syncing time data with external systems for a defined date window

If you’re currently fetching all time tracking entries and filtering by date on the client side, you can now offload that filtering to the API for improved performance and simpler code.

New parameters

Parameter Type Required Description
entered_on_start_date string No ISO 8601 date (e.g., 2025-10-01). Returns entries with entered_on on or after this date (inclusive).
entered_on_end_date string No ISO 8601 date (e.g., 2025-11-01). Returns entries with entered_on on or before this date (inclusive).

Both parameters are optional and can be used independently or together. They work alongside the existing query parameters (task, attributable_to, portfolio, user, workspace).

Usage

Retrieve all time tracking entries for a specific user within a portfolio for October 2025:

// GET /time_tracking_entries with date range filters
GET /time_tracking_entries?portfolio=123456789&user=1208625811880568&entered_on_start_date=2025-10-01&entered_on_end_date=2025-10-31

Example response:

{
  "data": [
    {
      "gid": "12345",
      "resource_type": "time_tracking_entry",
      "duration_minutes": 120,
      "entered_on": "2025-10-14",
      "attributable_to": {
        "gid": "67890",
        "resource_type": "project",
        "name": "Q4 Marketing Campaign"
      },
      "created_by": {
        "gid": "1208625811880568",
        "resource_type": "user",
        "name": "Greg Sanchez"
      }
    }
  ]
}

Timeline

Available now!

Resources

Questions and feedback

If you have questions or feedback about this change, please reply to this thread.

1 Like