---
title: "Preview"
method: POST
path: "/v1/matters/{matter_id}/timekeeper/rates/{practitioner_id}/preview"
tags: ["timekeeper"]
---

# Preview

`POST /v1/matters/{matter_id}/timekeeper/rates/{practitioner_id}/preview`

## 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/matters/{matter_id}/timekeeper/rates/{practitioner_id}/preview`
- Auth: HTTP bearer

## Path parameters

- `practitioner_id` string, uuid, required
- `matter_id` string, uuid, required

## Request body

- SetPractitionerRate
  - `effective_from` string, date, required
  - `review_sha256` string, nullable
  - `hourly_rate` string, decimal, required
  - `expected_version` integer, nullable
  - `role_id` string, uuid, nullable
  - `reason` string
  - `use_firm_default` boolean

## Response `200`

Successful Response

- PractitionerRatePreview
  - `posted_entry_count` integer, required
  - `hourly_rate` string, decimal, required
  - `position` string, nullable, required
  - `impacts` RateImpact[], required
    - `work_date` string, date, required
    - `entry_count` integer, required
    - `duration_minutes` integer, required
    - `previous_value` string, decimal, nullable, required
    - `proposed_value` string, decimal, required
  - `review_sha256` string, required
  - `expected_version` integer, 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/bf4373130521?raw)