Create public service request
LogsPOST /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_idphoneotp_codefull_nameaddressRequired unless plus_code is given
plus_codelocalitylandmarkconnection_typeone of
residential,commercial,industrial,institutional,governmentchallenge_tokenBot-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
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"
}'
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$PUBLIC_API/service-requests", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"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"
})
});
const data = await res.json();
import requests
res = requests.post(
"$PUBLIC_API/service-requests",
json={
"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"
}
)
data = res.json()
body := strings.NewReader(`{
"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"
}`)
req, _ := http.NewRequest("POST", "$PUBLIC_API/service-requests", body)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
{
"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"
}