List the consumer's prepaid meters
LogsGET /prepaid/meters
Pages the prepaid meters on accounts where the caller has the payment permission, across tenants unless X-Tenant-ID selects one. An empty page is returned when the caller has no such account. Pagination uses limit and after.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Returns
200 Prepaid meters linked to the consumer's authorized accounts
Show attributes
dataShow child attributes
idtenant_idmeter_idmeter_holder_nameDisplay name of the customer who holds the account the meter is installed on. Omitted when unknown.
meter_serialaccount_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.
customer_idcustomer_nameDisplay name of the referenced customer. Omitted when unknown.
tariff_idstatusone of
active,suspendedvending_key_refbalance_centscreated_atupdated_at
has_morenext_cursortotal_count
curl -X GET "$CONSUMER_API/prepaid/meters" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$CONSUMER_API/prepaid/meters", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$CONSUMER_API/prepaid/meters",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$CONSUMER_API/prepaid/meters", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "pre_2RtGgr5UObHqSN9K4rD24l9KoHf",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"meter_holder_name": "Ana Matsinhe",
"meter_serial": "meter serial",
"account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
"account_number": "ACC-2026-000142",
"account_holder_name": "Ana Matsinhe",
"customer_id": "cus_2UuXtOGTHWKlvkoF5so5Joi3Hck",
"customer_name": "Ana Matsinhe",
"tariff_id": "tar_2gW5z8815MeLds61bycBrS8bPMC",
"status": "active",
"vending_key_ref": "vending key ref",
"balance_cents": 125000,
"created_at": "2026-11-19T09:30:00Z",
"updated_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor",
"total_count": 125000
}