CLclickup
Tasks

Get Bulk Tasks' Time in Status

Changed on

View how long two or more tasks have been in each status. The Total time in Status ClickApp must first be enabled by the Workspace owner or an admin.

get/v2/task/bulk_time_in_status/task_ids

Request

  • Base URL
    https://api.clickup.com/api
  • URL
    https://api.clickup.com/api/v2/task/bulk_time_in_status/task_ids
  • Auth
    API key in header Authorization

Query parameters

task_idsstring required

Include this paramater once per task_id. You can include up to 100 task ids per request. For example: task_ids=3cuh&task_ids=g4fs

custom_task_idsboolean
Example:true

If you want to reference a task by it's custom task id, this value must be true.

team_idnumber
Example:123

When the custom_task_ids parameter is set to true, the Workspace ID must be provided using the team_id parameter.
For example: custom_task_ids=true&team_id=123.

Headers

Content-Type'application/json' required
Example:application/json

Response

Example response

{
  "27075wz": {
    "current_status": {
      "status": "open",
      "color": "#d3d3d3",
      "total_time": {
        "by_minute": 21830,
        "since": "1604004423494"
      }
    },
    "status_history": [
      {
        "status": "open",
        "color": "#d3d3d3",
        "type": "open",
        "total_time": {
          "by_minute": 21829,
          "since": "1604004423494"
        },
        "orderindex": 0
      },
      {
        "status": "active status #2",
        "color": "#5CF1D4",
        "type": "custom",
        "total_time": {
          "by_minute": 23274,
          "since": "1602607941692"
        },
        "orderindex": 4
      }
    ]
  },
  "20bbn28": {
    "current_status": {
      "status": "open",
      "color": "#d3d3d3",
      "total_time": {
        "by_minute": 21830,
        "since": "1604004420925"
      }
    },
    "status_history": [
      {
        "status": "open",
        "color": "#d3d3d3",
        "type": "open",
        "total_time": {
          "by_minute": 22276,
          "since": "1604004420925"
        },
        "orderindex": 0
      },
      {
        "status": "active status #2",
        "color": "#5CF1D4",
        "type": "custom",
        "total_time": {
          "by_minute": 40109,
          "since": "1601597828835"
        },
        "orderindex": 4
      }
    ]
  }
}

Changes

  • a0a72ec97ddbRevision changes
    • breaking

      the / response's property type changed from no type to object for status

    • breaking

      the // response's property type changed from no type to object for status

    • breaking

      the / response's property type changed from no type to object for status

    • breaking

      the // response's property type changed from no type to object for status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status