---
title: "Create a review detail"
method: POST
path: "/leases/{lease_id}/charges/reviews/{review_id}/details"
tags: ["Leases"]
---

# Create a review detail

`POST /leases/{lease_id}/charges/reviews/{review_id}/details`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/charges/reviews/{review_id}/details`
- Auth: HTTP bearer

Create a new detail line for a charge review

## Path parameters

- `lease_id` string, uuid, required
- `review_id` string, uuid, required

## Request body

- CreateChargeReviewDetail: Create a new review detail line.
  - `annual_charge_review_id` string, uuid, required
  - `lease_charge_id` string, uuid, required
  - `provisional_amount` number, required
  - `actual_amount` number, required
  - `difference_amount` number, required
  - `calculation_details` object, nullable
  - `supporting_documents` object, nullable

## Response `201`

Review detail created successfully

- ChargeReviewDetail: A detail line within an annual charge review (Art. 23 Loi 89-462). Each detail represents one charge's provisional vs. actual amounts.
  - `id` string, uuid, required
  - `annual_charge_review_id` string, uuid, required: Parent review ID
  - `lease_charge_id` string, uuid, required: The charge being reviewed
  - `provisional_amount` number, required: Amount provisioned during the period
  - `actual_amount` number, required: Actual expense amount
  - `difference_amount` number, required: Difference (actual - provisional). Positive = underpayment, negative = overpayment
  - `calculation_details` object, nullable: Details of the calculation (JSON)
  - `supporting_documents` object, nullable: References to supporting documents (JSON)
  - `status` 'DRAFT' | 'CALCULATED' | 'VALIDATED' | 'DISPUTED' | 'ADJUSTED' | 'CLOSED', required: Status of a review detail line.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)