---
title: "Get timers"
method: GET
path: "/projects/{project_id}/tasks/{task_id}/timers"
tags: ["task"]
---

# Get timers

`GET /projects/{project_id}/tasks/{task_id}/timers`

## Request

- Base URL: `https://api.ora.pm`
- URL: `https://api.ora.pm/projects/{project_id}/tasks/{task_id}/timers`
- Auth: OAuth 2
  - Authorization code: `https://app.ora.pm/authorize`
  - Token URL: `https://api.ora.pm/oauth/token` scopes: `read`, `write`

## Query parameters

- `offset` string
- `limit` string

## Response `200`

Success

- TaskTimer
  - `user_id` integer: Id of the user that started the timer.
  - `checklist_id` integer: If the timer is started on a checklist then checklist_id is the id of that checklist.
  - `task_title` string: Title of the task where the timer is started.
  - `status` string: Status of the timer.
  - `created_at` string, date-time: Date and time when the timer was created.
  - `total` string: Total time the timer tracked.
  - `last_time` string: Time spent last time.
  - `ended_at` string, date-time: Date and time when the timer has been stopped.
  - `archived` boolean: True if the timer is archived
  - `notes` string: Notes for the timer.

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/ora/apis/ora-api.md) - [All operations](https://skmtc.dev/ora/apis/ora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ora/apis/ora-api/revisions/983b9e0b0dda?raw)