Skip to content
TTrackTimer

TrackTimer for developers

Build with the TrackTimer API.

View Markdown

Use the TrackTimer REST API to find accessible clients and projects, control your project timer, and read your time entries. Build a personal integration or connect tracked hours to your own tools.

Working with an AI agent? Connect through the hosted MCP server to control timers, correct your time, and review monthly earnings.

Base URL

https://www.tracktimer.app/api/v1

All endpoints require a bearer API key. Keys belong to one user and one workspace. Examples use placeholders, not real credentials.

Make your first request

  1. Sign in to your workspace and create a personal API key in Settings. Read authentication and key management first.
  2. Call List clients, then List projects with a returned client ID.
  3. Start a timer using a returned project ID and an idempotency key. Starting a timer can stop your existing active timer.
  4. Stop the timer and read the saved record through List time entries.
curl "https://www.tracktimer.app/api/v1/clients" \
  --header "Authorization: Bearer $TRACKTIMER_API_KEY"

In these shell examples, TRACKTIMER_API_KEY is a local placeholder variable you supply securely. Keep credentials in your server-side secret store; do not embed them in a public website or commit them.

Endpoint reference

POST /api/v1/projects

Create a project

Create a project as a workspace admin and automatically join it.

GET /api/v1/clients

List clients

Discover active workspace clients according to the API key owner’s role.

GET /api/v1/projects

List projects for a client

Find assigned, unarchived projects for a client in the key’s workspace.

GET /api/v1/timer

Get the active timer

Read the key owner’s current timer in the bound workspace.

POST /api/v1/timers/start

Start or switch a timer

Start a project timer and atomically complete any timer already running for the user.

POST /api/v1/timers/{timerId}/stop

Stop a timer

Complete a timer owned by the key user in the bound workspace.

GET /api/v1/time-entries

List personal time entries

Read personal workspace history with project filtering and cursor pagination.

What this API covers

V1 exposes the seven operations documented here, including project creation for owners and admins. It does not expose client creation, invoices, or agency-wide financial reports. API access follows the key owner's current workspace membership and project access.

Errors and safe retries · Pagination

Documentation downloads