Meter inspection requests

Base URL: $CONSUMER_API

The object

idstring · required
tenant_idstring · required
account_idstring · required
account_numberstring · optional

Number of the referenced account, e.g. CTA-000044. Omitted when unknown.

account_holder_namestring · optional

Display name of the customer who holds the referenced account. Omitted when unknown.

meter_idstring · required
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

identity_idstring · required
requester_namestring · optional

Who filed it, which can differ from the account holder.

reasonstring · required
idempotency_keystring · optional
kindstring · optional

one of consumer, field_reread

reading_idstring · optional
statusstring · required

one of open, scheduled, completed, cancelled

scheduled_atstring · optional · nullable
resolutionstring · optional
resolved_bystring · optional
resolved_atstring · optional · nullable
created_atstring (date-time) · required
updated_atstring (date-time) · required
The object
{
  "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"
}

List inspection requests for a linked account

Logs

GET /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.

Parameters

tenant_idstring · query · required

Tenant (utility workspace) that owns the account; when omitted it is worked out from the caller's account memberships.

account_idstring · query · required

Required identifier of the linked account whose inspection requests are listed.

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

Returns

200 Consumer inspection requests in the selected linked account

Show attributes
dataarray of MeterInspectionRequest · required
Show child attributes
idstring · required
tenant_idstring · required
account_idstring · required
account_numberstring · optional

Number of the referenced account, e.g. CTA-000044. Omitted when unknown.

account_holder_namestring · optional

Display name of the customer who holds the referenced account. Omitted when unknown.

meter_idstring · required
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

identity_idstring · required
requester_namestring · optional

Who filed it, which can differ from the account holder.

reasonstring · required
idempotency_keystring · optional
kindstring · optional

one of consumer, field_reread

reading_idstring · optional
statusstring · required

one of open, scheduled, completed, cancelled

scheduled_atstring · optional · nullable
resolutionstring · optional
resolved_bystring · optional
resolved_atstring · optional · nullable
created_atstring (date-time) · required
updated_atstring (date-time) · required
has_moreboolean · required
next_cursorstring · optional
curl -X GET "$CONSUMER_API/meter-inspection-requests" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "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"
}

Submit consumer meter inspection request

Logs

POST /meter-inspection-requests

Request a meter inspection for an explicitly authorized account

Asks the utility to inspect a meter on a linked account, for example when the caller suspects it is faulty. account_id, meter_id, a reason of up to 500 characters and an idempotency_key of up to 160 characters are required; the caller needs the ticket create permission and the meter must belong to the account (403 otherwise). Resending the same key with the same content returns the existing request, while the same key with different content returns 409; the request is created open and the call answers 202.

Body application/json

tenant_idstring · required
account_idstring · required
meter_idstring · required
reasonstring · required
idempotency_keystring · required

Returns

202 Inspection request submitted

Show attributes
idstring · required
tenant_idstring · required
account_idstring · required
account_numberstring · optional

Number of the referenced account, e.g. CTA-000044. Omitted when unknown.

account_holder_namestring · optional

Display name of the customer who holds the referenced account. Omitted when unknown.

meter_idstring · required
meter_serialstring · optional

Serial number of the referenced meter. Omitted when unknown.

meter_holder_namestring · optional

Display name of the customer who holds the account the meter is installed on. Omitted when unknown.

identity_idstring · required
requester_namestring · optional

Who filed it, which can differ from the account holder.

reasonstring · required
idempotency_keystring · optional
kindstring · optional

one of consumer, field_reread

reading_idstring · optional
statusstring · required

one of open, scheduled, completed, cancelled

scheduled_atstring · optional · nullable
resolutionstring · optional
resolved_bystring · optional
resolved_atstring · optional · nullable
created_atstring (date-time) · required
updated_atstring (date-time) · required

Errors 400 · 403 · 404 · 409

curl -X POST "$CONSUMER_API/meter-inspection-requests" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
  "meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
  "reason": "Leitura confirmada no local.",
  "idempotency_key": "idempotency key"
}'
Response 202
{
  "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"
}