List timers

List timers in one user, team, or repo scope, optionally filtered by lifecycle status.

New to deferred work? Read the Timers and future signals guide or follow recurring repository maintenance.

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
GET /api/v1/teams/{team_slug}/timers
GET /api/v1/teams/{team_slug}/repos/{repo_slug}/timers
GET /api/v1/users/{username}/repos/{repo_slug}/timers

Authenticated Paged

Query parameters

status: active, paused, completed, or cancelled.
page: 1-based page number.
per_page: number of timers per page.

GET /api/v1/users/alice/timers?status=active&page=1&per_page=20

Success

200 OK with the standard page envelope. Each item in results has the timer response shape shown below.

{
  "next": null,
  "previous": null,
  "results": [
    { "uuid": "8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6", "status": "active", "...": "..." }
  ]
}

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"
}