Resolve an invitation link
LogsPOST /utility-invitations/open
Resolves the one-time token from the invitation landing page and records the invitation as opened. Returns the utility name, country, setup mode, masked owner contact and expiry so the page can be prefilled. Expired, revoked or used tokens return 410 without saying whether any account exists.
Body application/json
tokenOne-time token from the invitation link
Returns
curl -X POST "$PUBLIC_API/utility-invitations/open" \
-H "Content-Type: application/json" \
-d '{
"token": "token"
}'
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$PUBLIC_API/utility-invitations/open", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"token": "token"
})
});
const data = await res.json();
import requests
res = requests.post(
"$PUBLIC_API/utility-invitations/open",
json={
"token": "token"
}
)
data = res.json()
body := strings.NewReader(`{
"token": "token"
}`)
req, _ := http.NewRequest("POST", "$PUBLIC_API/utility-invitations/open", body)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
{
"utility_name": "Ana Matsinhe",
"country_code": "MZ",
"setup_mode": "invite",
"owner_contact_masked": "owner contact masked",
"contact_kind": "email",
"expires_at": "2026-11-19T09:30:00Z"
}