---
title: "List charge notifications"
method: GET
path: "/leases/{lease_id}/charges/notifications"
tags: ["Leases"]
---

# List charge notifications

`GET /leases/{lease_id}/charges/notifications`

## Request

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

Retrieve the list of charge notifications for a lease

## Path parameters

- `lease_id` string, uuid, required

## Response `200`

Notifications retrieved successfully

- ChargeNotification[]
  - `id` string, uuid, required
  - `lease_id` string, uuid, required: Lease this notification relates to
  - `notification_type` 'CONSUMPTION_ALERT' | 'ANNUAL_REVIEW' | 'REGULARIZATION_DUE' | 'DOCUMENTATION_REQUEST', required: Type of charge notification. - `CONSUMPTION_ALERT`: Alert about unusual consumption patterns - `ANNUAL_REVIEW`: Annual charge review notification - `REGULARIZATION_DUE`: Regularization is due for the period - `DOCUMENTATION_REQUEST`: Request for supporting documents
  - `content` object, required: Notification content (JSON)
  - `sent_date` string, date-time, nullable: Date when the notification was sent
  - `status` 'DRAFT' | 'SENT' | 'READ' | 'ACTIONED' | 'EXPIRED', required: Status of a charge notification.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

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