Time a Job ← Back to home

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:

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:

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.