Sign in
Time tracking entries

Get multiple time tracking entries

<b>Required scope: </b><code>time_tracking_entries:read</code>

Returns a list of time tracking entries filtered to a task, attributed project, portfolio or user.

get/time_tracking_entries

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/time_tracking_entries
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: time_tracking_entries:read)

Query parameters

taskstring

Globally unique identifier for the task to filter time tracking entries by.

attributable_tostring

Globally unique identifier for the project the time tracking entries are attributed to.

portfoliostring

Globally unique identifier for the portfolio to filter time tracking entries by.

userstring

Deprecated - please use assignee instead Globally unique identifier for the user the time tracking entry's logged time is attributed to, to filter time tracking entries by.

assigneestring

Globally unique identifier for the user the time tracking entry's logged time is attributed to, to filter time tracking entries by.

workspacestring

Globally unique identifier for the workspace. At least one of entered_on_start_date or entered_on_end_date must be provided when filtering by workspace.

entered_on_start_datestring date

The start date for filtering time tracking entries by when they were entered.

entered_on_end_datestring date

The end date for filtering time tracking entries by when they were entered.

timesheet_approval_statusstring

Globally unique identifier for the timesheet approval status to filter time tracking entries by.

limitinteger

Results per page. The number of objects to return per page. The value must be between 1 and 100.

offsetstring

Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Response

Successfully retrieved the requested time tracking entries.

Example response

{
  "data": [
    {
      "gid": "12345",
      "resource_type": "time_tracking_entry",
      "duration_minutes": 12,
      "entered_on": "2015-03-14",
      "attributable_to": {
        "gid": "12345",
        "resource_type": "project",
        "name": "Stuff to buy",
        "resource_subtype": "default_project"
      },
      "assignee": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      },
      "created_by": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      },
      "categories": [
        {
          "gid": "12345",
          "resource_type": "time_tracking_category",
          "name": "Development",
          "color": "blue"
        }
      ]
    }
  ],
  "next_page": {
    "offset": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
    "path": "/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
    "uri": "https://app.asana.com/api/1.0/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9"
  }
}

Changes

No operation changes recorded.