---
title: "Period Entries"
method: POST
path: "/v1/workspaces/{workspace_id}/timekeeper/entries/search"
tags: ["timekeeper"]
---

# Period Entries

`POST /v1/workspaces/{workspace_id}/timekeeper/entries/search`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/workspaces/{workspace_id}/timekeeper/entries/search`
- Auth: HTTP bearer

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- PeriodEntriesSearch
  - `matter_id` string, uuid, nullable
  - `lost_time_only` boolean
  - `task_category` 'assets' | 'creditors' | 'employees' | 'trade_on' | 'investigation' | 'dividend' | 'administration' | 'lost_time'
  - `status` 'open' | 'posted', nullable
  - `matter_type` string
  - `search` string
  - `cursor` string, nullable
  - `start_date` string, date, required
  - `end_date` string, date, required

## Response `200`

Successful Response

- PeriodTimeEntries
  - `start_date` string, date, required
  - `end_date` string, date, required
  - `entries` TimeEntryView[], required
    - `dependent_drawings` DrawingDependency[], required
      - `id` string, uuid, required
      - `drawing_date` string, date, required
      - `amount` string, decimal, required
    - `id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `matter_id` string, uuid, nullable, required
    - `matter_name` string, required
    - `matter_code` string, required
    - `matter_type` string, required
    - `outside_appointment` boolean, required
    - `practitioner_user_id` string, uuid, required
    - `practitioner_name` string, required
    - `position` string, nullable, required
    - `charging_role` string, nullable, required
    - `charging_rate_id` string, uuid, nullable, required
    - `rate_effective_from` string, date, nullable, required
    - `work_date` string, date, required
    - `task_category` 'assets' | 'creditors' | 'employees' | 'trade_on' | 'investigation' | 'dividend' | 'administration' | 'lost_time', required
    - `task_subcategory_id` string, nullable, required
    - `task_subcategory_label` string, nullable, required
    - `task_taxonomy_version` string, nullable, required
    - `template_source` TemplateSourceOutput, required: The library entry and reviewed mapping that proposed a classification. Provenance reported by the editor, not authority: the reviewed pair is the entry's category and subcategory. A null default means the mapping was unresolved and the practitioner classified the entry themselves. Commands check the default against the taxonomy; reads tolerate a newer taxonomy's.
      - `library` 'corporate' | 'bankruptcy' | 'sbr', required
      - `template_id` string, required
      - `mapping_version` string, required
      - `default_subcategory_id` string, nullable, required
    - `absence_kind` 'annual_leave' | 'sick_leave' | 'personal_leave' | 'bereavement_leave' | 'public_holiday' | 'jury_duty' | 'medical_appointment' | 'staff_function', required: Lost Time excluded from productivity and utilisation; training is not.
    - `narrative` string, required
    - `duration_minutes` integer, required
    - `start_minute` integer, nullable, required
    - `status` 'open' | 'posted' | 'superseded' | 'discarded', required
    - `version` integer, required
    - `posted_at` string, date-time, nullable, required
    - `superseded_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `hourly_rate` string, decimal, nullable, required
    - `value` string, decimal, nullable, required
    - `billed` string, decimal, required
    - `written_off` string, decimal, required
    - `absorbed` string, decimal, required
    - `outstanding` string, decimal, required
    - `lock_reason` 'period_locked' | 'period_closed' | 'billed' | 'approved' | 'written_off' | 'other_practitioner', nullable, required
  - `next_cursor` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/a5849ac366ca?raw)