---
title: "Time Entries · Practice Manager API · COUNT Partner API"
description: "Time entries record minutes logged by a person against projects, customers, and billable services. Partner responses use UUIDs; entries in processed pay…"
canonical: "https://developers.getcount.com/practice-manager/reference/time-entries"
source: "https://developers.getcount.com/practice-manager/reference/time-entries"
---
Practice Manager API

# Time Entries

Time entries record minutes logged by a person against projects, customers, and billable services. Partner responses use UUIDs; entries in processed pay periods are read-only.

Last updated 2026-11-18

## Overview

The Time Entries API provides full CRUD for logged time in a workspace. Create one or more rows in a single POST by passing `peopleUuid` and a `timeEntries` array. Updates use PATCH (not PUT).

Soft-deleted entries are excluded from list and return 404 on retrieve. Entries tied to a processed pay period cannot be updated or deleted until the pay period is adjusted.

## Key concepts

### Batch create

POST accepts `peopleUuid` plus `timeEntries: [{ date, minutes, ... }]`. The server validates the daily minutes cap across all rows for the same person and date.

### UUID filter params

List filters use `peopleUuids`, `projectUuids`, `customerUuids`, and `productServiceUuids` (comma-separated). Direct numeric filters are stripped server-side.

### Date window

Both `startDate` and `endDate` (YYYY-MM-DD) must be provided together for the createdAt range filter to apply. Passing only one is ignored.

### Processed pay periods

PATCH and DELETE return 400 when the entry belongs to a processed pay period.

## The time entry object

Fields returned on a time entry. Nested people, project, customer, and productService expose UUIDs.

#### Attributes

`id` uuid

Time entry identifier (UUID).

`date` date

Calendar date of the entry (YYYY-MM-DD).

`minutes` integer

Minutes logged. Daily total per person cannot exceed 1440 (24 hours).

`description` string

Optional notes for the entry.

`billable` boolean

Whether the time is billable.

`wage` number

Wage rate applied when set.

`people` object

Person who logged the time.

`project` object

Linked project, or null.

`customer` object

Linked customer, or null. May auto-fill from project.

`productService` object

Billable product or service, or null.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "id": "33445566-7788-99aa-bbcc-ddeeff001122",
  "date": "2026-03-15",
  "minutes": 120,
  "description": "Wireframe review session",
  "billable": true,
  "wage": 45,
  "people": {
    "uuid": "f1a2b3c4-d5e6-4789-a012-3456789abcde",
    "firstName": "Jane",
    "lastName": "Smith"
  },
  "project": {
    "uuid": "11223344-5566-7788-99aa-bbccddeeff00",
    "name": "Website Redesign"
  },
  "customer": {
    "uuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
    "customer": "Acme Corporation"
  },
  "productService": {
    "uuid": "aa11bb22-cc33-dd44-ee55-ff6677889900",
    "description": "Consulting services"
  },
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}
```

peopleUuid required on create

Create requires a non-empty `peopleUuid` from the People API. On update, `peopleUuid` cannot be cleared — passing null or empty string returns 400.

Subscription required

Time entry routes require an active workspace subscription (`checkSubscription` middleware).

## Related

- [People API](https://developers.getcount.com/practice-manager/reference/people)
- [Projects API](https://developers.getcount.com/practice-manager/reference/projects)
- [Products & Services API](https://developers.getcount.com/practice-manager/reference/products-and-services)

## Endpoints

[GET List time entries `/firm-partners/workspace/time-entries` Returns a paginated list of time entries.](https://developers.getcount.com/practice-manager/reference/time-entries/list-time-entries) [GET Get a time entry `/firm-partners/workspace/time-entries/{uuid}` Retrieves a single time entry by UUID.](https://developers.getcount.com/practice-manager/reference/time-entries/get-time-entry) [POST Create time entries `/firm-partners/workspace/time-entries` Creates one or more time entry rows for a person.](https://developers.getcount.com/practice-manager/reference/time-entries/create-time-entry) [PATCH Update a time entry `/firm-partners/workspace/time-entries/{uuid}` Updates an existing time entry. Only the fields you send are changed.](https://developers.getcount.com/practice-manager/reference/time-entries/update-time-entry) [DELETE Delete a time entry `/firm-partners/workspace/time-entries/{uuid}` Soft-deletes a time entry.](https://developers.getcount.com/practice-manager/reference/time-entries/delete-time-entry)
