---
title: "Get timer status"
method: GET
path: "/v3/timer/status"
tags: ["[v3] Timer"]
---

# Get timer status

`GET /v3/timer/status`

Return current timer status for the authenticated user.

## Headers

- `Accept` string
- `Content-Type` string

## Response `200`

OK

- object
  - `timer` object, required
    - `isRunning` boolean, required — Whether authenticated user has a running timer.
    - `id` integer, nullable — Running timer id.
    - `startedAt` string, nullable — Local timer start time.
    - `elapsed` integer, required — Timer elapsed time in seconds.
    - `browserPluginButtonHash` string, nullable — Browser plugin button hash assigned to the timer.
  - `entry` object, nullable, required
    - `id` integer, nullable — Time entry id assigned to the running timer.
    - `note` string, nullable — Running timer note.
  - `task` object, nullable, required
    - `id` integer, nullable — Task id assigned to the running timer.
    - `name` string, nullable — Task name assigned to the running timer.
    - `externalTaskId` string, nullable — External task id normalized for the requesting service.
    - `billable` 0 | 1, nullable — Billable flag copied from the running timer.
  - `presentation` object, nullable — Client-specific presentation data, currently returned for chrome plugin requests.
    - `color` string, nullable — Task color.
    - `breadcrumb` string, nullable — Task breadcrumb.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-08-27** `047f6ac362aa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/timecamp/apis/timecamp-api/changes/v3/timer/status/get.md)

---

[API](https://skmtc.dev/timecamp/apis/timecamp-api.md) · [All operations](https://skmtc.dev/timecamp/apis/timecamp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/timecamp/timecamp-api/revisions/047f6ac362aa/schema)