Privacy-first time tracking API

Build time tracking workflows on Timether.

The Timether API is a JSON REST API for projects, clients, time entries, timers, invoices, workspace settings, audit logs, and connected apps. It is designed for trust-based work records, not employee surveillance.

Getting Started

Create an API token from Timether, then send it as a bearer token with each request. Existing clients can continue using the legacy /api/v1 path on the app domain, but new integrations should use https://api.timether.com/v1.

curl https://api.timether.com/v1/me \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Authentication

Use Authorization: Bearer YOUR_API_TOKEN. Missing or invalid tokens return 401 with a JSON error payload.

Workspace Selection

Tokens use their default workspace unless you pass X-Workspace-Id. Use this header when a user belongs to multiple workspaces.

Error Shape

Errors return { "error": { "message": "..." } }. Some authorization failures include code, action, or role.

Common Requests

Use the interactive reference below to inspect request bodies, response payloads, and available endpoints. Most write endpoints wrap parameters in a top-level resource key such as project, client, or time_entry.

curl https://api.timether.com/v1/projects \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": {
      "name": "Client Work",
      "hourly_rate_cents": 12500
    }
  }'

API Reference

Explore every endpoint from the OpenAPI contract.