Installation history filtered by connection or meter
LogsGET /meter-installations
Returns installation records (meter, connection, account, installation time, initial reading and seal number) across the tenant, with cursor pagination. With no filter every installation is returned. Requires the business:meters:read permission.
Parameters
connection_idReturns only installations on this connection.
meter_idReturns only installations of this meter.
openWhen
trueor 1, returns only installations that are still in place (the meter has not been removed); any other value returns open and closed installations.limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Returns
200 Installations, newest first
Show attributes
dataShow child attributes
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
Permissions business:meters:read · Roles: admin, analyst, billing_clerk, customer_service, field_reader, field_supervisor, operations, owner, viewer
curl -X GET "$BUSINESS_API/meter-installations" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/meter-installations", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/meter-installations",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/meter-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"
}