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
iduuidTime entry UUID.
datedateDay the work was done (YYYY-MM-DD).
minutesintegerMinutes worked.
notesstringWhat the time was spent on.
isBillablebooleanWhether the time is billable.
isBilledbooleanWhether the time has been invoiced.
unitPricestringRate override, as a decimal string. Usually null; the service carries the rate.
peopleobjectThe staff member: name, email, avatar and `type`.
projectobjectThe firm project, or null.
customerobjectThe firm’s billing customer, or null. `customer` is the display name.
productServiceobjectThe service, with `unitPrice` (decimal string) and `pricingMethod`, or null.
taskobjectThe firm task, or null.
createdAtdatetimeCreation timestamp.
updatedAtdatetimeLast update timestamp.
{
"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.Related
Endpoints
/firm-partners/firm/time-entriesReturns a page of the firm’s time entries, newest date first.
/firm-partners/firm/time-entries/{uuid}Retrieves one firm time entry.
/firm-partners/firm/time-entriesLogs time for a staff member.
/firm-partners/firm/time-entries/{uuid}Updates the fields you send and leaves the rest unchanged.
/firm-partners/firm/time-entries/{uuid}Deletes a firm time entry.
