Practice Manager API

Firm Time Entries

Time the firm’s own staff log against its billing customers, projects, services and tasks — the practice’s timesheets, not a client’s payroll.

Last updated 2026-10-23

Overview

Firm time entries live in the firm’s own workspace. Each records minutes a staff member spent on a date, optionally against the firm’s billing customer for a client, a project, a service (which carries the rate) and a firm task. They are separate from `/firm-partners/workspace/time-entries`, which is payroll time inside a client’s books.

Reads need `time-entries:read` and writes need `time-entries:write`. Needs a key with access to all client workspaces. A key limited to selected client workspaces gets 403 on this route.

Key concepts

Records in the firm’s own workspace

Staff, customers, services and projects on a time entry are records in the firm’s own workspace. Read their UUIDs through the client workspace routes with `count-workspace-id` set to the firm’s workspace (the last row of List client workspaces).

A task sets the project

When `taskUuid` names a task whose project is in the firm’s workspace, the entry takes that project and its customer, overriding any `projectUuid` or `customerUuid` you sent.

The firm time entry object

Nested `people`, `project`, `customer`, `productService` and `task` objects carry COUNT’s internal numeric `id`, not a UUID — read them for display, not as input to other routes.

Attributes

iduuid

Time entry UUID.

datedate

Day the work was done (YYYY-MM-DD).

minutesinteger

Minutes worked.

notesstring

What the time was spent on.

isBillableboolean

Whether the time is billable.

isBilledboolean

Whether the time has been invoiced.

unitPricestring

Rate override, as a decimal string. Usually null; the service carries the rate.

peopleobject

The staff member: name, email, avatar and `type`.

projectobject

The firm project, or null.

customerobject

The firm’s billing customer, or null. `customer` is the display name.

productServiceobject

The service, with `unitPrice` (decimal string) and `pricingMethod`, or null.

taskobject

The firm task, or null.

createdAtdatetime

Creation timestamp.

updatedAtdatetime

Last update timestamp.

Example
{
  "id": "6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f",
  "date": "2026-10-20",
  "minutes": 90,
  "notes": "Payroll reconciliation",
  "isBillable": true,
  "isBilled": false,
  "unitPrice": null,
  "people": {
    "id": 8812,
    "firstName": "Dana",
    "lastName": "Okafor",
    "email": "dana@northwind.example",
    "avatarUrl": null,
    "type": "employee"
  },
  "project": {
    "id": 402,
    "name": "Harbor Coffee – Monthly close"
  },
  "customer": {
    "id": 9931,
    "customer": "Harbor Coffee Co."
  },
  "productService": {
    "id": 77,
    "name": "Bookkeeping (hourly)",
    "unitPrice": "150.0000",
    "pricingMethod": "hourly"
  },
  "task": {
    "id": 120345,
    "name": "Q3 sales tax filing"
  },
  "createdAt": "2026-10-21T10:04:05.000Z",
  "updatedAt": "2026-10-21T10:04:05.000Z"
}

Client projects are not accepted

List firm projects also returns projects in client workspaces, but `projectUuid` here must be a project in the firm’s own workspace; any other returns 404.

Endpoints