Time Entries

Time entry object represents spent time for a person.

Time can be spent tracking on a service or on a time off event.

When tracked on a service, time entry can also belong to a task.

When time entry belongs to a task, time tracked on time entry represents task worked time and will decrease time to complete on the task.

Time entry can represent:

  • Worked hours (without start and end time)
  • Worked time period (with start and end time) - in a form of a timer. More on timers here.

Following diagram shows time entries in our data hierarchy:

ServiceTaskTime EntryTimer

You can find out more about Time entries in our Help documentation for My Time

Attributes

after string
Parameter `filter`

after of the time entry.

approval_policy_id integer
Parameter `filter`

approval policy id of the time entry.

approval_statuses array of approval status
Response

Per-approver decisions on this time entry.

approved object
Response

Whether this time entry has been approved.

approved_at string
Response Parameter `filter`

Timestamp when the time entry was approved.

approver person
Response

The person who approved this time entry.

approver_id integer
Parameter `filter`

approver id of the time entry.

assigned_approver_id integer
Parameter `filter`

assigned approver id of the time entry.

autotracked boolean
Parameter `filter`

autotracked of the time entry.

awaiting_approval_from_approver_id integer
Parameter `filter`

awaiting approval from approver id of the time entry.

base_cost object
Parameter `filter`

Base labor cost before overhead (serialized from work_cost).

before string
Parameter `filter`

before of the time entry.

billable boolean
Parameter `filter`

Whether the associated service is billable.

billable_time integer
Response Request Parameter `filter`

Hours billable to clients (time + correction for billable services, zero for non-billable).

billing_type_id integer
Parameter `filter` Enum

Billing type of the associated service.

Enum Values (4 values)

  • 1
  • 2
  • 3
  • 4
booking_id integer
Parameter `filter`

ID of the booking this time entry was created from.

budget_id integer
Parameter `filter`

ID of the deal/budget this time was tracked on.

budget_type_id integer
Parameter `filter`

Budget type ID of the associated deal.

calendar_event_id string
Response Request

ID of the calendar event this entry was created from, if applicable.

company_id integer
Parameter `filter`

ID of the client company associated with the deal.

cost object
Response Parameter `filter`

Total cost of tracked time, including labor and overhead costs.

cost_default object
Response

Total cost in the organization's default currency.

cost_normalized object
Response

Total cost in the normalized reporting currency.

created_after string
Parameter `filter`

Filter alias — only entries created after this value.

created_at string
Response Parameter `filter`

Date on which the time entry was created.

created_before string
Parameter `filter`

Filter alias — only entries created before this value.

creator person
Response

The person who created this time entry.

creator_id integer
Parameter `filter`

creator id of the time entry.

currency string
Response

Currency code for financial values on this time entry.

currency_default object
Response

Currency code in the organization's default currency.

currency_normalized object
Response

Currency code in the normalized reporting currency.

date string
Response Request Parameter `filter` Parameter `sort`

Date for which the time was tracked.

deal_id integer
Parameter `filter`

ID of the deal/budget this time was tracked on.

deal_name object
Parameter `sort`

Name of the deal/budget this time was tracked on.

deal_subsidiary subsidiary
Response

The subsidiary of the budget/deal this time was tracked on.

deal_subsidiary_id integer
Parameter `filter`

ID of the subsidiary of the deal.

designated_approver_id integer
Parameter `filter`

Filter time entries to those whose budget has the specified designated approver.

ended_at string
Parameter `filter`

Computed end timestamp (started_at + time minutes).

facility_overhead_cost object
Response Parameter `filter`

Facility overhead portion of the cost.

facility_overhead_cost_default object
Response

Facility overhead cost in the organization's default currency.

facility_overhead_cost_normalized object
Response

Facility overhead cost in the normalized reporting currency.

id integer
Parameter `filter`

Unique identifier of the time entry.

intercompany_hours boolean
Parameter `filter`

True when the person's subsidiary differs from the deal subsidiary.

internal_overhead_cost object
Response Parameter `filter`

Internal overhead portion of the cost.

internal_overhead_cost_default object
Response

Internal overhead cost in the organization's default currency.

internal_overhead_cost_normalized object
Response

Internal overhead cost in the normalized reporting currency.

invoice_attribution invoice attribution
Response

The invoice attribution linking this entry to an invoice.

invoice_attribution_id integer
Response Parameter `filter`

ID of the invoice attribution linking this entry to an invoice.

invoiced boolean
Response Parameter `filter`

Whether this time entry has been invoiced to the client.

invoice_id integer
Parameter `filter`

ID of the invoice associated via attribution.

invoicing_status integer
Parameter `filter` Enum

Current invoicing status of the time entry.

Enum Values (3 values)

  • 1
  • 2
  • 3
jira_issue_id string
Response Request Parameter `filter`

Jira Issue ID if tracked from a Jira integration.

jira_issue_status string
Response Request Parameter `filter`

Current status of the linked Jira issue.

jira_issue_summary string
Response Request Parameter `filter`

Summary text of the linked Jira issue.

jira_organization string
Response Request

Jira organization name for the linked issue.

jira_worklog_id string
Response Request Parameter `filter`

Jira Worklog ID for synced entries.

last_activity_at string
Response Parameter `filter`

Date when the last change was made (edit, approval, move, etc.).

last_actor person
Response

The last person who made changes to this entry.

last_actor_id integer
Parameter `filter`

last actor id of the time entry.

note string
Response Request Parameter `filter`

Description of what the person was working on.

organization organization
Response

The organization this time entry belongs to.

overhead boolean
Response Parameter `filter`

Whether this time entry is included in overhead calculations.

overhead_cost object
Response Parameter `filter`

Total overhead cost (internal + facility) of tracked time.

overhead_cost_default object
Response

Total overhead cost in the organization's default currency.

overhead_cost_normalized object
Response

Total overhead cost in the normalized reporting currency.

parent_company_id integer
Parameter `filter`

Filter time entries by the parent company of the client linked to their budget.

people_custom_fields string
Parameter `filter`

Custom field values for the person who tracked time.

person person
Response

The person who tracked this time.

person_id integer
Request Parameter `filter`

ID of the person who tracked time.

person_name object
Parameter `sort`

Name of the person who tracked time.

person_subsidiary subsidiary
Response

The subsidiary of the person who tracked time.

person_subsidiary_id integer
Parameter `filter`

ID of the subsidiary of the person who tracked time.

person_tags string
Parameter `filter`

Tags of the person who tracked time.

project_id integer
Parameter `filter`

ID of the project associated with the service.

project_manager_id integer
Parameter `filter`

ID of the project manager.

project_type_id integer
Parameter `filter`

Project type ID.

query string
Parameter `filter`

Full-text search query across time entry fields.

recognized_time integer
Response

Recognized time used in budget spending and accrual-based revenue calculations.

rejected object
Response

Whether this time entry was rejected during approval.

rejected_at string
Response

Timestamp when the time entry was rejected.

rejected_reason string
Response

Reason provided when the time entry was rejected.

rejecter person
Response

The person who rejected this time entry.

responsible_id integer
Parameter `filter`

ID of the responsible person.

role_id integer
Parameter `filter`

Role ID of the person who tracked time.

section_name string
Parameter `filter`

Name of the section the service belongs to.

service service
Response

The budget service this time was tracked against.

service_id integer
Request Parameter `filter`

ID of the service the time was tracked against.

service_name object
Parameter `sort`

Name of the service the time was tracked against.

service_type_id integer
Parameter `filter`

Service type ID of the associated service.

stage_type integer
Parameter `filter` Enum

Stage type of the associated deal.

Enum Values (2 values)

  • 1
  • 2
started_after string
Parameter `filter`

Filter alias — only entries started after this value.

started_at string
Response Request Parameter `filter`

Start date and time of the time entry.

started_before string
Parameter `filter`

Filter alias — only entries started before this value.

status integer
Parameter `filter` Enum

Approval status of the time entry.

Enum Values (6 values)

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
submitted object
Response

Whether this time entry has been submitted for approval via a timesheet.

task task
Response

The task the person was working on.

task_id integer
Request Parameter `filter`

ID of the task the person was working on.

task_list_id integer
Parameter `filter`

ID of the task list the task belongs to.

time integer
Response Request Parameter `filter`

Duration of work in minutes.

timer_started_at string
Response

When the timer was started (if tracked via timer).

timer_stopped_at string
Response

When the timer was stopped.

timesheet timesheet
Response

The daily timesheet this entry belongs to (unit of approval submission).

track_method_id integer
Response Parameter `filter` Enum

How the time was recorded: manually, via timer, or mixed.

Enum Values (6 values)

  • 1
    Manual tracking
  • 2
    Timer tracking
  • 3
    Auto tracking
  • 4
    Mixed tracking
  • 5
    Autogenerated
  • 6
    AI Generated
unit_id integer
Parameter `filter` Enum

Tracking unit ID of the associated service.

Enum Values (3 values)

  • 1
  • 2
  • 3
updated_at string
Response Parameter `filter` Parameter `sort`

Timestamp of last modification.

updater person
Response

The person who last updated this time entry.

use_salary_currency boolean
Request

Whether to compute costs using the person's salary currency instead of the deal currency.

work_cost object
Response

Labor cost based on the person's salary rate.

work_cost_default object
Response

Labor cost in the organization's default currency.

work_cost_normalized object
Response

Labor cost in the normalized reporting currency.