# FairePlace Charges API

**Canonical:** https://apis.io/apis/faireplace-com/faireplace-com-charges-api/  
**Provider:** FairePlace — https://apis.io/providers/faireplace-com/  
**Base URL:** https://api.faireplace.com/api  
**Documentation:** https://developers.faireplace.com/api

FairePlace Charges API is one of 56 APIs that [FairePlace](https://apis.io/providers/faireplace-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Charges. The published artifact set on APIs.io includes an OpenAPI specification.

Rental charge management including freeze periods, distribution references, notifications, regulations, reviews, audit logs, and meter associations. ## Key features - **Freeze Periods**: Legislative freeze periods that block charge modifications (Art. 17-2 Loi 89-462) - **Distribution References**: Historical reference values for distribution key calculations - **Notifications**: Consumption alerts, annual review notices, regularization reminders - **Regulations**: Charge adjustments due to freeze periods or legal exceptions - **Reviews**: Annual charge regularization process (Art. 23 Loi 89-462) - **Audit Logs**: Full traceability of charge modifications - **Meters**: Physical meter associations with leases and charges

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| GET | `/charges/freeze-periods` | List all freeze periods |
| POST | `/charges/freeze-periods` | Create a freeze period |
| GET | `/charges/freeze-periods/{id}` | Get a freeze period |
| PUT | `/charges/freeze-periods/{id}` | Update a freeze period |
| DELETE | `/charges/freeze-periods/{id}` | Delete a freeze period |
| GET | `/charges/distribution-references` | List distribution references |
| POST | `/charges/distribution-references` | Create a distribution reference |
| GET | `/charges/distribution-references/{id}` | Get a distribution reference |
| PUT | `/charges/distribution-references/{id}` | Update a distribution reference |
| DELETE | `/charges/distribution-references/{id}` | Delete a distribution reference |
| GET | `/charges/readings` | List all charge readings |
| POST | `/charges/readings` | Create a global charge reading |
| GET | `/charges/readings/{reading_id}` | Get a charge reading |
| PUT | `/charges/readings/{reading_id}` | Update a charge reading |
| DELETE | `/charges/readings/{reading_id}` | Delete a charge reading |
| GET | `/charges/readings/{reading_id}/validate` | Validate a charge reading |
| GET | `/leases/{lease_id}/charges/{charge_id}/readings` | List charge readings |
| POST | `/leases/{lease_id}/charges/{charge_id}/readings` | Create charge reading |
| GET | `/leases/{lease_id}/charges/installments` | List regularization installments |
| POST | `/leases/{lease_id}/charges/installments` | Create installment schedule |
| DELETE | `/leases/{lease_id}/charges/installments` | Delete all installments for lease |
| GET | `/leases/{lease_id}/charges/installments/{installment_id}` | Get installment |
| PUT | `/leases/{lease_id}/charges/installments/{installment_id}` | Update installment |
| GET | `/leases/{lease_id}/charges/distribution-references` | List distribution references for a lease |
| POST | `/leases/{lease_id}/charges/distribution-references` | Create a distribution reference for a lease |
| GET | `/leases/{lease_id}/charges/distribution-references/{id}` | Get a lease distribution reference |
| PUT | `/leases/{lease_id}/charges/distribution-references/{id}` | Update a lease distribution reference |
| DELETE | `/leases/{lease_id}/charges/distribution-references/{id}` | Delete a lease distribution reference |
| POST | `/leases/{lease_id}/charges/{charge_id}/calculate-meter` | Calculate meter-based charge |
| POST | `/charges/distributions/{key_id}/calculate-distribution` | Calculate a charge distribution |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/faireplace-com/openapi/faireplace-com-charges-api-openapi.yml

## Other FairePlace APIs (12)

- [FairePlace Amendment Documents API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-documents-api/)
- [FairePlace Amendment Duration Details API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-duration-details-api/)
- [FairePlace Amendment History API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-history-api/)
- [FairePlace Amendment Notifications API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-notifications-api/)
- [FairePlace Amendment Rent Details API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-rent-details-api/)
- [FairePlace Amendment Validations API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-validations-api/)
- [FairePlace Charge Configuration API](https://apis.io/apis/faireplace-com/faireplace-com-charge-configuration-api/)
- [FairePlace Condition Reports API](https://apis.io/apis/faireplace-com/faireplace-com-condition-reports-api/)
- [FairePlace Contacts API](https://apis.io/apis/faireplace-com/faireplace-com-contacts-api/)
- [FairePlace Countries API](https://apis.io/apis/faireplace-com/faireplace-com-countries-api/)
- [FairePlace Coupons API](https://apis.io/apis/faireplace-com/faireplace-com-coupons-api/)
- [FairePlace Credits API](https://apis.io/apis/faireplace-com/faireplace-com-credits-api/)

## Tags

Charges

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/faireplace-com/faireplace-com-charges-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/faireplace-com/.