Listar pedidos de vistoria
RegistosGET /meter-inspection-requests
Returns inspection requests for the tenant's meters, both those raised by consumers and the field re-reads raised by staff, with cursor pagination. Filters combine with AND; an unknown status returns 400. Requires the business:inspection-requests:read permission.
Parâmetros
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
account_idReturns only requests raised for this customer account.
meter_idReturns only requests for this meter.
statusRequest state: open, scheduled, completed or cancelled; any other value returns 400.
um de
open,scheduled,completed,cancelledkindWho raised the request: consumer for a request from the account holder, or field_reread for a re-read raised by staff.
um de
consumer,field_reread
Devolve
200 Tenant-scoped inspection requests
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
Permissões business:inspection-requests:read · Funções: admin, analyst, customer_service, field_supervisor, operations, owner
curl -X GET "$BUSINESS_API/meter-inspection-requests" \
-H "Authorization: Bearer sk_test_..."
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$BUSINESS_API/meter-inspection-requests", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/meter-inspection-requests",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_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"
}