Meters
List Meters
Access
Member of the organization with this permission:
meters:read
An API key with scopes also needs the permission among its scopes.
GET
Lists meters with pagination, filtering, and sorting. Supports filtering by type, provider, terrain, and search. Can include relations like terrain (with nested occupations and customer), lastReading, alarms, and metadata. Use 'customer' or 'occupation' in include to fetch nested data through terrain.
ApiKeyAuthheader
x-api-key<token>API key for authentication
organizationId*stringThe ID or slug of the organization
page?integerRange
-9007199254740991 <= value <= 9007199254740991limit?integerRange
-9007199254740991 <= value <= 9007199254740991sortBy?stringValue in
"id""name""serial""type""provider""customFields""createdAt""updatedAt""terrainId""lastReadingId""manualMetadata""meterCabinetId"sortDir?stringValue in
"asc""desc"include?|array<>|stringterrainId?string|array<string>|nulllastReadingId?string|array<string>|nullmeterCabinetId?string|array<string>|nulltype?|array<>|provider?|array<>|createdAt?|nullupdatedAt?|nullname?string|array<string>|serial?string|array<string>|customFields?manualMetadata?hasReadings?boolean|string|number|nullhasNoReadings?boolean|string|number|nullhasAlarms?boolean|string|number|nullhasNoAlarms?boolean|string|number|nullhasAnomalies?boolean|string|number|nullhasNoAnomalies?boolean|string|number|nullhasConsumptionBatches?boolean|string|number|nullhasNoConsumptionBatches?boolean|string|number|nullhasComments?boolean|string|number|nullhasNoComments?boolean|string|number|nullhasTasks?boolean|string|number|nullhasNoTasks?boolean|string|number|nullhasEventLogs?boolean|string|number|nullhasNoEventLogs?boolean|string|number|nullhasAuditLogs?boolean|string|number|nullhasNoAuditLogs?boolean|string|number|nullreadingId?string|array<string>|alarmId?string|array<string>|anomalyId?string|array<string>|consumptionBatchId?string|array<string>|commentId?string|array<string>|taskId?string|array<string>|eventLogId?string|array<string>|auditLogId?string|array<string>|hasTerrain?boolean|string|number|nullhasNoTerrain?boolean|string|number|nullhasLastReading?boolean|string|number|nullhasNoLastReading?boolean|string|number|nullhasMeterCabinet?boolean|string|number|nullhasNoMeterCabinet?boolean|string|number|nullsearch?stringhasActiveAlarms?boolean|string|number|nullswitchOn?boolean|string|number|nullOK
application/json- response
curl -X GET 'https://api.tillor.eu/orgs//meters'Example Response
null