Meters

List meters

List meters with optional filters

get/meters

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/meters
  • Auth: HTTP bearer

Query parameters

place_idstring uuid

Filter by place ID

estate_idstring uuid

Filter by estate ID

service_place_idstring uuid

Filter by service place ID

meter_typestring

Filter by meter type

statusstring

Filter by status

billing_typestring

Filter by billing type

is_main_meterboolean

Filter by main meter flag

pageinteger

Page number

limitinteger

Number of items per page

Response

Meters retrieved successfully

idstring uuid required
place_idstring uuid nullable

Place where the meter is installed

estate_idstring uuid nullable

Estate (lot) where the meter is installed

service_place_idstring uuid nullable

Associated service (e.g., electricity service for the building)

meter_type'ELECTRICITY' | 'GAS' | 'WATER_HOT' | 'WATER_COLD' | 'HEATING' | 'COOLING' required

Type of meter.

  • ELECTRICITY: Electrical consumption meter
  • GAS: Gas consumption meter
  • WATER_HOT: Hot water meter
  • WATER_COLD: Cold water meter
  • HEATING: Heating meter (calories)
  • COOLING: Cooling/AC meter
billing_type'INDIVIDUAL' | 'COLLECTIVE' | 'SHARED' | 'INCLUDED' required

How the meter is used for billing.

  • INDIVIDUAL: Meter for a single tenant
  • COLLECTIVE: Shared meter for the building
  • SHARED: Shared among specific tenants with ratios
  • INCLUDED: Consumption included in rent (informational only)
serial_numberstring required

Unique serial number (unique per tenant)

manufacturerstring nullable

Meter manufacturer

model_referencestring nullable

Model reference

installation_datestring date required

Date the meter was installed (cannot be in the future)

last_inspection_datestring date nullable

Date of last inspection (must be >= installation_date)

next_inspection_datestring date nullable

Date of next planned inspection

unit'KWH' | 'M3' | 'L' | 'KCAL' | 'BTU' required

Unit of measurement for the meter.

multipliernumber required

Reading multiplier (default 1.0, must be > 0)

status'ACTIVE' | 'INACTIVE' | 'MAINTENANCE' | 'REPLACED' | 'REMOVED' required

Current operational status of the meter.

is_main_meterboolean required

Whether this is the main meter (vs. sub-meter)

parent_meter_idstring uuid nullable

Parent meter ID (for sub-meter hierarchy)

max_valuenumber nullable

Maximum value before rollover (for rollover detection)

precision_digitsinteger required

Number of decimal digits for readings

notesstring nullable
created_atstring date-time required
updated_atstring date-time required

Example response

[
  {
    "meter_type": "ELECTRICITY",
    "billing_type": "INDIVIDUAL",
    "serial_number": "EDF-2024-001234",
    "manufacturer": "Itron",
    "model_reference": "Linky G3",
    "unit": "KWH",
    "status": "ACTIVE"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.