---
title: "Start, stop, get timer"
method: POST
path: "/timer"
tags: ["[v1] Timer"]
---

# Start, stop, get timer

`POST /timer`

Get timer status, start new timer or stop one.

## Request body

- object
  - `action` 'status' | 'start' | 'stop', required — either `status`, `start` or `stop`
  - `task_id` integer — start a task with a given task
  - `started_at` string — timer will count time since this date only when `action` = `start`
  - `stopped_at` string — timer will count time to this date only when `action` = `stop`

## Response `200`

OK

- object
  - `isTimerRunning` boolean
  - `elapsed` number
  - `entry_id` union
    - number
    - string
  - `timer_id` union
    - number
    - string
  - `start_time` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

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