GET /api/time_entries
Get time entries list

Get a list of all time entries accessible to user.

Access rights:

  • Regular users can see only their own time entries.
  • User's time entries can also be seen by their approvers.
  • Cost centers' approvers and managers can also see all time entries for their cost centers.
  • Cost centers' managers cannot edit time entries.
  • Accountants and managers can see all time entries in the company.

Examples

{
  "collection": [
    {
      "id": 12,
      "entry_type": "work_time",
      "start_time": "2025-02-21T09:08:58.000Z",
      "date": "2025-02-21",
      "description": "Doing something important",
      "task_id": 175,
      "external_id": "abcd",
      "task_name": "Some Task",
      "is_task_billable": true,
      "task_notes": "These are the notes for Some Task",
      "cost_center_id": 18,
      "cost_center_name": "Project 660: Some Name",
      "user_id": 819,
      "user_name": "John Smith",
      "user_email": "john@test.com",
      "minutes": 60,
      "billable_minutes": 60,
      "invoiced_at": null,
      "reported_at": null,
      "is_locked": false,
      "updated_at": 1742464038
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1
  }
}

Params

Param name Description
page
optional

Page number.

Validations:

  • Must be a Integer
per_page
optional

Number of records per page. Default: 50.

Validations:

  • Must be a Integer
q
optional

Pass query to filter time entries by description or task name. Case-insensitive.

Validations:

  • Must be a String
date_range
optional

Get all time entries within the specified date range. Date range format: "DD/MM/YYYY - DD/MM/YYYY" (e.g. 15/02/2025 - 28/02/2025).

Validations:

  • Must be a String
start_date
optional

Get all time entries starting from the specified date, e.g. 2025-01-31.

Validations:

  • Must be a String
end_date
optional

Get all time entries up to and including the specified date, e.g. 2025-01-31.

Validations:

  • Must be a String
updated_after
optional

Get all time entries updated after the specifiex Unix timestamp.

Validations:

  • Must be a Integer
cost_center_id
optional

Get all time entries for the specified cost center (project).

Validations:

  • Must be a Integer
task_id
optional

Get all time entries for the specidied task.

Validations:

  • Must be a Integer
external_id
optional

Retrieve all time entries where the external_id contains the given substring (case-insensitive).

Validations:

  • Must be a String
user_id
optional

Get all time entries for the specified user.

Validations:

  • Must be a Integer
sort_by
optional

Sort by field. Default: date.

Validations:

  • Must be a String
order
optional

Sorting order (descending or ascending). Default: asc.

Validations:

  • Must be one of: desc, asc.