Listar pedidos de vistoria
RegistosGET /meter-inspection-requests
Pages the meter inspection requests that consumers raised on 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.
Parâmetros
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 inspection requests are listed.
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
Devolve
200 Consumer inspection requests in the selected linked account
Mostrar atributos
dataMostrar atributos filhos
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.
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.
identity_idrequester_nameWho filed it, which can differ from the account holder.
reasonidempotency_keykindum de
consumer,field_rereadreading_idstatusum de
open,scheduled,completed,cancelledscheduled_atresolutionresolved_byresolved_atcreated_atupdated_at
has_morenext_cursor
curl -X GET "$CONSUMER_API/meter-inspection-requests" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$CONSUMER_API/meter-inspection-requests", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$CONSUMER_API/meter-inspection-requests",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$CONSUMER_API/meter-inspection-requests", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "met_22OXlyuNjQGrXkQbdCkn18WvtcE",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
"account_number": "ACC-2026-000142",
"account_holder_name": "Ana Matsinhe",
"meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
"meter_serial": "meter serial",
"meter_holder_name": "Ana Matsinhe",
"identity_id": "ide_2W4tFuAzbOoV5aORlgwJHqwRdkg",
"requester_name": "Ana Matsinhe",
"reason": "Leitura confirmada no local.",
"idempotency_key": "idempotency key",
"kind": "consumer",
"reading_id": "rdg_2o0xXwujnSgR9QIvVEWblWSv7u0",
"status": "open",
"scheduled_at": "2026-11-19T09:30:00Z",
"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"
}