API
Programmatic access to your own data: four read endpoints and one write endpoint to log time. Included on every plan, no extra fee.
Authentication
Generate a key from your dashboard's Settings page, under "API access". Send it as a bearer token on every request:
Authorization: Bearer taj_live_...
A key only ever returns data for your own account, and it acts for the whole account the way the owner would, so treat it like a password. Keys can be revoked any time from the same Settings panel — a revoked key stops working immediately. Each key is limited to 120 requests per minute.
Base URL
https://timeajob-backend.onrender.com/api/v1
Endpoints
GET /clients
Your non-archived clients.
GET /projects
Your non-archived projects.
GET /time-entries
Your logged time entries (most recent first, capped at 500). Optional query params:
project_id— only entries for one projectfrom/to— date range, e.g.?from=2026-09-01&to=2026-09-30
GET /invoices
Your invoices with computed totals (most recent first, capped at 500).
POST /time-entries
Log a time entry. Send a JSON body with:
project_id(required) — the project to log againststarted_at(required) — an ISO 8601 date and timeduration_minutes(required) — a numbertask_id,note,billable(optional;billabledefaults to true)
Returns 201 with the new entry. Returns 404 if the project is not yours and
409 if the entry would take the project past its hard budget cap. The entry is attributed to
the account owner and is approved automatically.
What's not here yet
This is deliberately a small start — four read resources, one write endpoint (logging a time entry), no pagination cursors, and no endpoints to edit or delete anything. If you need something this doesn't cover, tell us: support@timeajob.com.