---
title: "List meter readings"
method: GET
path: "/meters/{meter_id}/readings"
tags: ["Meters"]
---

# List meter readings

`GET /meters/{meter_id}/readings`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/meters/{meter_id}/readings`
- Auth: HTTP bearer

Retrieve the list of readings for a meter

## Path parameters

- `meter_id` string, uuid, required

## Query parameters

- `reading_type` string
- `is_billing_reading` boolean
- `start_date` string, date-time
- `end_date` string, date-time
- `page` integer
- `limit` integer

## Response `200`

Meter readings retrieved successfully

- object
  - `data` MeterReading[]
    - `id` string, uuid, required
    - `meter_id` string, uuid, required
    - `lease_id` string, uuid, nullable: Optional lease association
    - `reading_date` string, date-time, required: Date and time of the reading
    - `reading_type` 'MANUAL' | 'AUTOMATIC' | 'PHOTO' | 'ESTIMATED', required: How the reading was captured. - `MANUAL`: Manual entry by a person - `AUTOMATIC`: Automatic reading from connected meter - `PHOTO`: Reading from a photo (OCR) - `ESTIMATED`: Estimated value (not actual reading)
    - `value` number, required: The meter reading value
    - `previous_value` number, nullable: Previous reading value (auto-populated)
    - `consumption` number, nullable: Calculated consumption since last reading (auto-populated). Formula: `(value - previous_value) * multiplier` With rollover: `(max_value - previous_value + value) * multiplier`
    - `is_estimated` boolean, required: Whether the reading is an estimate
    - `is_billing_reading` boolean, required: Whether this reading is used for billing
    - `photo_url` string, nullable: URL to photo of the meter reading
    - `reader_name` string, nullable: Name of the person who took the reading
    - `notes` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer

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