v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB

Tasks

Get Task

Retrieve a single task with its time totals, estimate, and custom fields.

get/tasks/{task_id}

Path parameters

task_idstring required

Example:ev:3000010034

Task ID

Query parameters

opts_include_billinginteger

Example:1

Set to 1 to include billing data on returned tasks: rate (cents per hour) and amount (round(time * rate / 3600)). Requires billing permissions; otherwise billing is omitted.

Response

idstring required

namestring required

projectsstring[] required

List of projects ID

sectionnumber nullable

Section ID

labelsstring[]

positionnumber

descriptionstring nullable

dueAtstring nullable

Format: Y-m-d H:i:s

status'open' | 'closed'

attributesobject

Custom attributes from integration

metricsobject

Custom metrics from integration

unbillableboolean

Example response

{
  "id": "ev:9876543210",
  "name": "Task Name",
  "projects": [
    "ev:1234567890"
  ],
  "section": 1234,
  "labels": [
    "high",
    "bug"
  ],
  "position": 1,
  "dueAt": "2018-03-05 16:00:00",
  "status": "open",
  "time": {
    "total": 7200,
    "users": {
      "1304": 3600,
      "1543": 3600
    }
  },
  "estimate": {
    "total": 7200,
    "type": "overall",
    "users": {
      "1304": 3600,
      "1543": 3600
    }
  },
  "attributes": {
    "Client": "Everhour",
    "Priority": "high"
  },
  "metrics": {
    "efforts": 42,
    "expenses": 199
  }
}