Get timer

Fetch one timer by UUID through the scope that owns it.

Scope and access

User-scoped timers are private to the authenticated user.
Team-scoped timers can only be listed or managed by a team owner.
Repo-scoped timers can be listed and fetched by users with repo read access; creating, updating, or deleting one requires maintainer access.
A timer UUID is only reachable through its owning user, team, or repo scope.

Endpoints

GET /api/v1/users/{username}/timers/{timer_uuid}
GET /api/v1/teams/{team_slug}/timers/{timer_uuid}
GET /api/v1/teams/{team_slug}/repos/{repo_slug}/timers/{timer_uuid}
GET /api/v1/users/{username}/repos/{repo_slug}/timers/{timer_uuid}

Authenticated

Success

200 OK with the timer JSON. A timer addressed through the wrong scope returns 404 Not Found.

Timer response

{
  "uuid": "8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6",
  "message": "Review the release checklist",
  "scope": "user",
  "schedule_kind": "interval",
  "schedule": "Mon, Tue, Wed, Thu, Fri at 09:00 (America/New_York)",
  "run_at": null,
  "every_seconds": null,
  "time_of_day": "09:00",
  "days_of_week": ["Mon", "Tue", "Wed", "Thu", "Fri"],
  "timezone": "America/New_York",
  "status": "active",
  "next_run_at": "2026-08-24T13:00:00Z",
  "last_run_at": null,
  "run_count": 0,
  "created_at": "2026-08-22T22:00:00Z"
}