v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB
Timers

Get Running Timer

Retrieve the authenticated user's currently running timer, or an empty timer payload if none is running.

get/timers/current

Response

OK

status'active' | 'stopped' required
durationnumber

Timer duration in seconds

todaynumber

Today time by user in the timer task

startedAtstring
userDatestring
commentstring

Example response

{
  "status": "active",
  "duration": 16,
  "today": 7200,
  "startedAt": "2018-01-16 12:42:59",
  "userDate": "2018-01-16",
  "task": {
    "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
    }
  },
  "user": {
    "id": 1304,
    "name": "User Name",
    "headline": "CEO",
    "role": "admin",
    "status": "active"
  },
  "currentTaskTime": {
    "id": 2660155,
    "time": 3600,
    "user": 1304,
    "date": "2018-01-20",
    "task": {
      "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
      }
    },
    "comment": "some notes"
  }
}