The signed-in account (name, email, business details printed on invoices) and what this token may do (read or write). Call this first to confirm the connection.

Every active project with its client and hourly rate. Use the "label" ("Client / Project") or the id wherever a project is asked for. Set include_archived to also see archived ones.

Active clients, each with its active projects.

One client's billing details: full legal name and address as printed on invoices.

Time entries between two dates (inclusive), newest first, with totals per project and per day. Optionally limited to one project. Use this for 'what did I log last week' and to check a day before adding time.

Logged hours per project: all time and within a date range (for example this month).

The timer that is running now, with elapsed minutes, or null when none is running.

One calendar year: hours and earnings by quarter, month, client and project, plus invoices issued and paid (cash and accrual views).

Invoice history (newest 200 at most). Filter by text, client, paid status or issue-date range.

The frozen invoice as issued: seller, client, lines per project and totals. Set include_detail for the per-entry breakdown. Logos are left out.

The suggested next invoice number for a year, such as INV-2026-004.

Turn text like "1h30", "1:30" or "2.5" into whole minutes, the way UseHourly reads it.

Add one time entry: a project, a date, how long, and what was done. Give minutes or a duration text. This adds a new entry; it never merges with an existing one. Check list_entries first if the day may already be logged.

Add the same entry (project, minutes, note) on up to 31 dates. Days that already have time for this project are skipped and reported unless skip_existing is false.

Set one project's total minutes for up to 31 days: more than 0 creates or updates that day's single entry, 0 clears it. Days that hold several entries or a running timer are skipped and reported, never merged. A note, when given, is applied to every day written.

Change an entry's project, date, minutes or note. Only the fields you pass change.

Fold several entries (same project, same day) into the first one: minutes are added and notes joined. The others are removed.

Permanently delete one time entry. Confirm with the user before calling this.

Start a timer on a project. A timer that is already running is stopped first, so only one runs at a time.

Stop the running timer. Elapsed time is rounded up to the next minute (at least 1).

Add a client. Names are unique per account.

Rename a client or change the legal name and address printed on its invoices. Only the fields you pass change; the logo is kept.

Hide a client from the lists. Its time and invoices are kept.

Add a project under a client, with an hourly rate in dollars and whether it is billable.

Rename a project, move it to another client, or change its rate or billable flag. Only the fields you pass change.

Hide a project from the lists. Its time and invoices are kept.

Bring an archived project (and its client, if archived) back.

Issue an invoice for a client from billable time between two dates. Totals are computed on the server from the logged entries (one line per project). The number defaults to the next INV--NNN. This creates a permanent record; confirm the client, period and dates with the user first.

Record the date an invoice was paid (this matters for cash-basis taxes), or pass null to mark it unpaid again.

Permanently delete an invoice record. The time entries stay. Confirm with the user before calling this.