Get task count of a project

GET

/projects/{project_gid}/task_counts

Projects

Get an object that holds task count fields. All fields are excluded by default. You must opt in using opt_fields to get any information from this endpoint.

This endpoint has an additional rate limit and each field counts especially high against our cost limits.

Milestones are just tasks, so they are included in the num_tasks, num_incomplete_tasks, and num_completed_tasks counts.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://app.asana.com/api/1.0/projects//task_counts'

Response Example

200 - Example 1

{
  "data": {
    "num_completed_milestones": 3,
    "num_completed_tasks": 150,
    "num_incomplete_milestones": 7,
    "num_incomplete_tasks": 50,
    "num_milestones": 10,
    "num_tasks": 200
  }
}

Request

Path Params

project_gid

string

required

Responses

🟢200Successfully retrieved the requested project's task counts.

application/json

Body

data

object (TaskCountResponse)

optional

A response object returned from the task count endpoint.

num_completed_milestones

integer

optional

The number of completed milestones in a project.

Example:

num_completed_tasks

integer

optional

The number of completed tasks in a project.

Example:

150

num_incomplete_milestones

integer

optional

The number of incomplete milestones in a project.

Example:

num_incomplete_tasks

integer

optional

The number of incomplete tasks in a project.

Example:

num_milestones

integer

optional

The number of milestones in a project.

Example:

num_tasks

integer

optional

The number of tasks in a project.

Example:

200

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:31

Remove users from a project

Get projects a task is in