A time tracking API for your own time

Read your tracked time and record new time from your own scripts, dashboards and automations. A plain REST API with personal access tokens.

Part of Timetracker Premium, free for the first week.

curl "https://api.timetracker.live/api/v1/time/summary/?from=2026-10-19&to=2026-10-25" \
  -H "Authorization: Bearer tt_your_token"
{
  "period": { "from": "2026-10-19", "to": "2026-10-25" },
  "total_minutes": 2310.5,
  "uncategorised_minutes": 95.0,
  "by_activity": [
    { "activity_id": 4, "activity_name": "Work", "minutes": 1480.0 }
  ],
  "by_category": [
    { "category_id": 1, "category_name": "Career", "minutes": 1480.0 }
  ]
}

What it is for

Your time is yours. The API is how you take it somewhere else, or put it in from somewhere else.

Your numbers, anywhere

Pull totals by activity and category into a spreadsheet, a dashboard or a report you already have. Ask for a day, a month or up to a year.

Track from your own tools

Start, stop and switch a timer from a script, a shortcut or a button on a stream deck. Record time you forgot, or correct an entry.

A token that can only do what you allowed

Tick the permissions when you create it: read time, record time, read structure, change structure. Revoke it in Settings and it stops at once.

How it works

  1. 1. Start your free week

    Create a free account. Premium is free for the first week and includes the API.

  2. 2. Create a token

    Open Settings, then API, name the token and tick what it may do. Copy it when it appears: it is shown once.

  3. 3. Send a request

    Put the token in an Authorization header as a Bearer token and call the address below. Your time comes back as JSON.

What you can call

Everything lives under https://api.timetracker.live/api/v1/.

GET/time/summary/Totals for a period, by activity and by category
GET/time/entries/The entries of a period, a page at a time, filterable by tag
GET/time/current/What is running now
GET/goals/progress/Progress on your goals
POST/time/start/ /stop/ /switch/Control the timer
POST/time/entries/record/Record time that has already passed
PATCH/time/entries/{id}/ and /split/Correct an entry, or divide it in two
GET POST/activities/ /categories/ /tags/Read and create your structure, then change, move or delete it
GET/settings/Your settings

Start a timer

Name the activity by its id, which you get from the activities endpoint. If another activity is running, the request is refused rather than silently ending it.

curl -X POST "https://api.timetracker.live/api/v1/time/start/" \
  -H "Authorization: Bearer tt_your_token" \
  -H "Content-Type: application/json" \
  -d '{"activity_id": 4}'

Four permissions, no more

A token carries only the permissions you ticked. A request that needs more is refused with a code that says which one is missing.

  • time:readRead your tracked time
  • time:writeRecord and correct your time
  • structure:readRead your activities, categories and goals
  • structure:writeChange your activities, categories, goals and settings

Limit: 120 requests a minute per account. A refused request says how long to wait.

Every endpoint, parameter and error is in the API reference.

Would rather not write code? Connect Claude or ChatGPT instead

Frequently asked questions

Do I need Premium?

Yes. The public API is part of Timetracker Premium, which you can try free for a week. Without it, requests are refused with a code that says so, and nothing else about your account changes.

How do I sign in to the API?

With a personal access token. Create one in Settings, then API, and send it as a Bearer token in the Authorization header. The token is shown once, so copy it when it appears.

What can a token do?

Only what you tick when you create it: read your tracked time, record and correct your time, read your activities, categories and goals, or change them. Pick the smallest set your script needs.

What can I read and change?

Totals by activity and category, the entries themselves, what is running and goal progress. You can start, stop and switch timers, record past time, correct or split an entry, and manage activities, categories, tags and settings.

Is there a rate limit?

Yes, 120 requests a minute per account, however many tokens you have. A refused request says how long to wait, in the body and in the Retry-After header.

What do errors look like?

Every refusal is JSON with a sentence and a code. The codes tell the four common cases apart: unauthenticated, subscription_required, insufficient_scope and rate_limited, so a script can tell a bad token from a missing subscription.

Will the API change under my script?

The published address is versioned, under /api/v1/. Once something depends on it, a change to what it returns is a new version rather than an edit.

Can I connect an AI assistant instead?

Yes. The same Premium access includes a connector for Claude, ChatGPT and any assistant that supports remote MCP servers, with no code to write.

Also see: built-in pomodoro timer, vs Toggl, vs Clockify, or read the blog.

Take your time with you

Create a free account, then try Premium free for a week.

Create Free Account

Available on Android, iOS, Windows, Mac, Linux and Web