---
title: "Allocate fund call to leases"
method: POST
path: "/syndics/{syndic_id}/fund-calls/{call_id}/allocate"
tags: ["Syndic Fund Allocations"]
---

# Allocate fund call to leases

`POST /syndics/{syndic_id}/fund-calls/{call_id}/allocate`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/syndics/{syndic_id}/fund-calls/{call_id}/allocate`
- Auth: HTTP bearer

Distributes the recoverable lines of a fund call to leases based on millième values (tantièmes de copropriété).

**Allocation formula:**
```
allocated_amount = line_amount × (millieme_value / total_milliemes)
```

Rounding is handled by adjusting the last lease to ensure the exact total matches. Existing allocations for the same fund call are deleted and recreated (idempotent re-allocation).

## Path parameters

- `syndic_id` string, uuid, required
- `call_id` string, uuid, required

## Request body

- AllocateRequestDto: Request to allocate fund call lines to leases based on millièmes
  - `leases` LeaseMilliemeDto[], required
    - `lease_id` string, uuid, required
    - `millieme_value` number, required
  - `total_milliemes` number, required: Total millièmes of the copropriété

## Response `201`

Allocations created

- FundAllocationResponse[]
  - `id` string, uuid, required
  - `fund_call_line_id` string, uuid, required
  - `lease_id` string, uuid, required
  - `millieme_value` number, required: Millièmes for this lease
  - `total_milliemes` number, required: Total millièmes used for calculation
  - `allocated_amount` number, required: Calculated amount = line_amount × (millieme_value / total_milliemes)
  - `lease_charge_id` string, uuid, nullable: Link to the lease charge (set after link-charges)
  - `status` string, required: Allocation status
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found

---

[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)