---
title: "Stop a timer"
method: POST
path: "/tracker-entries/timer/stop"
tags: ["Tracker Timer"]
---

# Stop a timer

`POST /tracker-entries/timer/stop`

Stop the current running timer or a specific timer entry.

## Request body

- object
  - `entryId` string, uuid — Unique identifier of the specific timer entry to stop. If not provided, will stop the current running timer for the user
  - `assignedId` string, uuid, nullable — Unique identifier of the user whose timer should be stopped. If not provided, will use the authenticated user
  - `stop` string, date-time — Stop time in ISO 8601 format. If not provided, will use current time

## Response `200`

Timer stopped successfully.

- object
  - `data` union, required
    - object
      - `id` string, uuid, required — Unique identifier of the tracker entry
      - `createdAt` string, required — Date and time when the tracker entry was created in ISO 8601 format
      - `duration` number, nullable, required — Duration of the timer entry in seconds. -1 indicates running, null for paused, positive number for completed
      - `start` string, required — Start time of the tracker entry in ISO 8601 format
      - `stop` string, nullable, required — Stop time of the tracker entry in ISO 8601 format. Null for running timers.
      - `teamId` string, required — Unique identifier of the team that owns this tracker entry
      - `description` string, nullable, required — Description or notes for the tracker entry
      - `rate` number, nullable, required — Hourly rate applied to this tracker entry
      - `currency` string, nullable, required — Currency code for the rate in ISO 4217 format
      - `billed` boolean, required — Whether this tracker entry has been billed to the customer
      - `date` string, required — Date of the tracker entry in YYYY-MM-DD format
      - `user` object, required — User information for the person who created this tracker entry
        - `id` string, uuid, required — Unique identifier of the user
        - `fullName` string, required — Full name of the user
        - `avatarUrl` string, required — URL to the user's avatar image
      - `project` object, required — Project information associated with this tracker entry
        - `id` string, uuid, required — Unique identifier of the project
        - `createdAt` string, required — Date and time when the project was created in ISO 8601 format
        - `rate` number, nullable, required — Default hourly rate for the project
        - `currency` string, nullable, required — Currency code for the project rate in ISO 4217 format
        - `status` string, required — Current status of the project
        - `description` string, nullable, required — Description of the project
        - `name` string, required — Name of the project
        - `billable` boolean, nullable, required — Whether the project is billable to the customer
        - `estimate` number, nullable, required — Estimated total hours for the project
        - `customer` object, nullable, required — Customer information associated with the project
          - `id` string, required — Unique identifier of the customer
          - `name` string, required — Name of the customer or organization
    - object
      - `id` string, uuid, required
      - `discarded` true, required — Always true for discarded timer entries (duration < 60s)
      - `duration` number, required
      - `project` object, nullable
        - `id` string, uuid, required
        - `name` string, required
      - `trackerProject` object, nullable
        - `id` string, uuid, required
        - `name` string, required
      - `start` string, nullable, required
      - `stop` string, nullable, required
      - `description` string, nullable, required

## Other responses

- `default` — An error occurred

---

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