Skip to Content
TillorManual
Meters

Create Meter

Acesso

Membro da organização com esta permissão:

  • meters:write

Uma chave de API com scopes também precisa da permissão nos seus scopes.

POST
/orgs/{organizationId}/meters

Creates a new meter with the provided data.

Authorization

ApiKeyAuth
headerx-api-key<token>

API key for authentication

Path Parameters

organizationId*string

The ID or slug of the organization

Request Body

application/json
  1. body
name*string
Length1 <= length <= 255
type*string
Value in"ELECTRICITY""WATER""GAS"
customFields?
provider*unknown

Response Body

OK

application/json
  1. response
Example Request
curl -X POST 'https://api.tillor.eu/orgs//meters' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "type": "ELECTRICITY",  "provider": "MANUAL"}'
Example Response
null

List Meters 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.

Get Meter GET

Gets a meter by its ID. Supports virtual fields: customer, occupation (same as list endpoint). Use include parameter to include relations like terrain, lastReading.