---
title: "Suggestions"
method: GET
path: "/v1/workspaces/{workspace_id}/timekeeper/suggestions"
tags: ["timekeeper"]
---

# Suggestions

`GET /v1/workspaces/{workspace_id}/timekeeper/suggestions`

## 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/suggestions`
- Auth: HTTP bearer

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `cursor` string, nullable
- `page_size` integer, nullable

## Response `200`

Successful Response

- SuggestionPage
  - `suggestions` SuggestionView[], 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
    - `matter_id` string, uuid, nullable, required
    - `work_date` string, date, required
    - `task_category` 'assets' | 'creditors' | 'employees' | 'trade_on' | 'investigation' | 'dividend' | 'administration' | 'lost_time', required
    - `narrative` string, required
    - `duration_minutes` integer, nullable, required
    - `start_minute` integer, nullable, required
    - `id` string, uuid, required
    - `version` integer, required
    - `source_matter_id` string, uuid, nullable, required
    - `source_kind` 'audit' | 'outlook_calendar', required
    - `source_work_date` string, date, required
    - `clarification` string, nullable, required
    - `status` 'pending' | 'accepted', required
    - `accepted_entry_id` string, uuid, nullable, required
  - `next_cursor` string, nullable, required
  - `closed_dates` string[], required
  - `refresh_window` RefreshWindow, required: Monday starts of the earliest and latest weeks Refresh may generate.
    - `earliest_week` string, date, required
    - `latest_week` string, date, 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/bf4373130521?raw)