Listar instalações de um contador
RegistosGET /meters/{id}/installations
Returns every installation of this meter, past and current, with the connection, account, installation time, initial reading and seal number, using cursor pagination. Requires the business:meters:read permission.
Parâmetros
idID of the meter whose installation history is listed.
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Devolve
200 Installations, newest first
Mostrar atributos
dataMostrar atributos filhos
idtenant_idconnection_idconnection_holder_nameDisplay name of the customer who holds the referenced connection. Omitted when unknown.
meter_idmeter_serialSerial number of the referenced meter. Omitted when unknown.
meter_holder_nameDisplay name of the customer who holds the account the meter is installed on. Omitted when unknown.
account_idaccount_numberNumber of the referenced account, e.g. CTA-000044. Omitted when unknown.
account_holder_nameDisplay name of the customer who holds the referenced account. Omitted when unknown.
installed_atinitial_readingremoved_atfinal_readingexchange_reasoninstalled_bysecurity_seal_numberreplaced_installation_ididempotency_keycreated_atupdated_at
has_morenext_cursor
Permissões business:meters:read · Funções: admin, analyst, billing_clerk, customer_service, field_reader, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/meters/{id}/installations" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$BUSINESS_API/meters/{id}/installations", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/meters/{id}/installations",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/meters/{id}/installations", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "met_2yk9v6SNluyXngonlgs1hccPdGU",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"connection_id": "con_2wuJTWy9FOCTPGA3noGbHegbLaU",
"connection_holder_name": "Ana Matsinhe",
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"meter_serial": "meter serial",
"meter_holder_name": "Ana Matsinhe",
"account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
"account_number": "ACC-2026-000142",
"account_holder_name": "Ana Matsinhe",
"installed_at": "2026-11-19T09:30:00Z",
"initial_reading": "initial reading",
"removed_at": "2026-11-19T09:30:00Z",
"final_reading": "final reading",
"exchange_reason": "exchange reason",
"installed_by": "installed by",
"security_seal_number": "SEC-2026-000142",
"replaced_installation_id": "rep_2rLgATXYm9pMiLbYyNLwCPHAGTv",
"idempotency_key": "idempotency key",
"created_at": "2026-11-19T09:30:00Z",
"updated_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}