Service requests

Base URL: $PUBLIC_API

The object

idstring · required
statusstring · required

one of submitted, accepted, visit_scheduled, quoted, payment_pending, scheduled, completed, declined, withdrawn

pricedboolean · required
estimate_min_centsinteger (int64) · optional
estimate_max_centsinteger (int64) · optional
currencystring · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required
The object
{
  "id": "pub_2xPGwrxs6NLE2NvSIXby6fdkg31",
  "status": "submitted",
  "priced": true,
  "estimate_min_cents": 1,
  "estimate_max_cents": 1,
  "currency": "MZN",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Create public service request

Logs

POST /service-requests

Request a new connection with a verified phone, without an account

Verifies the phone code from POST $AUTH_API/phone-codes, finds or creates the person's consumer identity (no password) and files the request with the utility. The answer shows only the request's progress, never personal data.

Body application/json

tenant_idstring · required
phonestring · required
otp_codestring · required
full_namestring · optional
addressstring · optional

Required unless plus_code is given

plus_codestring · optional
localitystring · optional
landmarkstring · optional
connection_typestring · optional

one of residential, commercial, industrial, institutional, government

challenge_tokenstring · optional

Bot-challenge token when security.challenge is enabled (anonymous callers). Only UI requests (browser headers, the dashboard, or X-Client mobile or desktop) are challenged; API requests never are.

Returns

201 Request filed

Show attributes
idstring · required
statusstring · required

one of submitted, accepted, visit_scheduled, quoted, payment_pending, scheduled, completed, declined, withdrawn

pricedboolean · required
estimate_min_centsinteger (int64) · optional
estimate_max_centsinteger (int64) · optional
currencystring · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required

Errors 400 · 403 · 409 · 429 · 503

curl -X POST "$PUBLIC_API/service-requests" \
  -H "Content-Type: application/json" \
  -d '{
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "phone": "+258841234567",
  "otp_code": "OTP-2026-000142",
  "full_name": "Ana Matsinhe",
  "address": "Av. Julius Nyerere 1420, Maputo",
  "plus_code": "PLU-2026-000142",
  "locality": "locality",
  "landmark": "landmark",
  "connection_type": "residential",
  "challenge_token": "challenge token"
}'
Response 201
{
  "id": "pub_2xPGwrxs6NLE2NvSIXby6fdkg31",
  "status": "submitted",
  "priced": true,
  "estimate_min_cents": 1,
  "estimate_max_cents": 1,
  "currency": "MZN",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Follow a service request's progress by its id

Logs

GET /service-requests/{id}

Shows status and estimate only; no phone, name, address or decline reason.

Parameters

idstring · path · required

Identifier returned when the service request was created without an account; anyone holding it sees only the status, timestamps and, once priced, the estimate range, never the requester's contact details or address.

Returns

200 Request progress

Show attributes
idstring · required
statusstring · required

one of submitted, accepted, visit_scheduled, quoted, payment_pending, scheduled, completed, declined, withdrawn

pricedboolean · required
estimate_min_centsinteger (int64) · optional
estimate_max_centsinteger (int64) · optional
currencystring · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required

Errors 404

curl -X GET "$PUBLIC_API/service-requests/{id}"
Response 200
{
  "id": "pub_2xPGwrxs6NLE2NvSIXby6fdkg31",
  "status": "submitted",
  "priced": true,
  "estimate_min_cents": 1,
  "estimate_max_cents": 1,
  "currency": "MZN",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}