List consumer reading disputes
LogsGET /reading-disputes
List disputes for a reading linked to the authenticated consumer
Pages the disputes raised on meter readings of one linked account. account_id is required (400 without it) and the caller needs read access to the account, otherwise 403. Pagination uses limit and after.
Parameters
tenant_idTenant (utility workspace) that owns the account; when omitted it is worked out from the caller's account memberships.
account_idRequired identifier of the linked account whose reading disputes are listed.
reading_idReturns only disputes about this meter reading.
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Returns
200 Disputes in the selected linked account
Show attributes
dataShow child attributes
idtenant_idaccount_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.
reading_ididentity_idrequester_nameWho filed it, which can differ from the account holder.
reasonidempotency_keystatusone of
open,in_review,resolved,rejectedresolutionresolved_byresolved_atcreated_atupdated_at
has_morenext_cursor
curl -X GET "$CONSUMER_API/reading-disputes" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$CONSUMER_API/reading-disputes", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$CONSUMER_API/reading-disputes",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$CONSUMER_API/reading-disputes", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "rea_2ZFwubFQelpiuLny0PJuoljESL5",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
"account_number": "ACC-2026-000142",
"account_holder_name": "Ana Matsinhe",
"reading_id": "rdg_2o0xXwujnSgR9QIvVEWblWSv7u0",
"identity_id": "ide_2W4tFuAzbOoV5aORlgwJHqwRdkg",
"requester_name": "Ana Matsinhe",
"reason": "Leitura confirmada no local.",
"idempotency_key": "idempotency key",
"status": "open",
"resolution": "resolution",
"resolved_by": "resolved by",
"resolved_at": "2026-11-19T09:30:00Z",
"created_at": "2026-11-19T09:30:00Z",
"updated_at": "2026-11-19T09:30:00Z"
}
],
"has_more": true,
"next_cursor": "next cursor"
}