List unbilled time

GET/v1/time-entries/unbilled

Coming April 2027

This endpoint ships in April 2027. The shape shown here can still change before release.

Returns billable time entries that are not on an invoice yet.

Use this to see what you can bill a client before running Invoice unbilled time. Running timers are not included. This is also the MCP tool list_unbilled_time. See Time tracking.

Permission: time.view
Type: Read-only. Changes nothing.
Auth: API key, MCP token or signed-in session
Capability: list_unbilled_time
MCP tool: list_unbilled_time
CLI: freeinvoiceautomation time unbilled
Available: From April 2027

list_unbilled_time

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/time-entries/unbilled \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193fa01-1b2c-7d3e-8f4a-5b6c7d8e9f0a",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "client_id": "0193f2a0-5b1c-7d2e-8f3a-4b5c6d7e8f90",
      "user_id": "0193f29d-aa11-7b22-8c33-4d55e66f7788",
      "project_tag": "website-redesign",
      "description": "Homepage wireframes",
      "started_at": "2027-04-06T09:00:00Z",
      "ended_at": "2027-04-06T11:30:00Z",
      "duration_seconds": null,
      "is_running": false,
      "rate_minor": "5000",
      "currency": "USD",
      "billable": true,
      "invoiced_document_id": null,
      "invoiced_line_id": null,
      "created_at": "2027-04-06T09:00:00Z",
      "updated_at": "2027-04-06T11:30:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

Authorizationstringrequired

Bearer <api-key>. An API key from Settings > API keys, or an MCP token. See Authentication.

Query Parameters

business_idstring<uuid>

Only entries of this business.

client_idstring<uuid>

Only entries for this client.

project_tagstring

Only entries with this tag.

limitintegerdefault:50

Page size, 1 to 200.

cursorstring

Cursor from the previous page's next_cursor.

Response

200 - application/json

dataobject[]

The unbilled entries on this page.

next_cursorstring | null

Cursor for the next page, or null on the last page.

has_moreboolean

Whether another page exists.

Suggest edits Raise issue

Delete a time entryPrevious Invoice unbilled timeNext

list_unbilled_time

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/time-entries/unbilled \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193fa01-1b2c-7d3e-8f4a-5b6c7d8e9f0a",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "client_id": "0193f2a0-5b1c-7d2e-8f3a-4b5c6d7e8f90",
      "user_id": "0193f29d-aa11-7b22-8c33-4d55e66f7788",
      "project_tag": "website-redesign",
      "description": "Homepage wireframes",
      "started_at": "2027-04-06T09:00:00Z",
      "ended_at": "2027-04-06T11:30:00Z",
      "duration_seconds": null,
      "is_running": false,
      "rate_minor": "5000",
      "currency": "USD",
      "billable": true,
      "invoiced_document_id": null,
      "invoiced_line_id": null,
      "created_at": "2027-04-06T09:00:00Z",
      "updated_at": "2027-04-06T11:30:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}