Installation history of one meter
LogsGET /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.
Parameters
idID of the meter whose installation history is listed.
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/meters/{id}/installations" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
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"
}