The next one to three first-use steps
LogsGET /next-steps
Returns the next one to three actionable steps for the signed-in resident, chosen and ordered by the server from progress, review state, capabilities, counts and connectors; an empty list when nothing is waiting. Each step has a stable ID, localized title and line (saved language, then Accept-Language, then the platform default), the role that acts, a portable action ID the client maps to its own screen, and a help article ID from the shared help registry. Clients keep no step list or order of their own. GET is safe to retry and completes nothing. A linked resident with an open or partly paid invoice still due gets the single step pay_balance (journey resident_link, action resident.pay); a linked resident with nothing due never gets find_utility or verify_account. Requires an authenticated resident.
Parameters
X-First-Run-TokenOpaque run token from an earlier progress or next-steps response. It joins this request's first-use events to one run and carries no identity.
Returns
200 Next steps
Show attributes
audienceone of
platform,business,consumer,residentlocaleone of
pt-MZ,en-USgenerated_atstepsShow child attributes
idjourney_idtitlelinestateone of
todo,blockedownerone of
you,platform_review,team_member,utility_owneractionShow child attributes
idPortable destination intent each client maps to its own screen
labelLocalized action label
routeIn-app route on the platform dashboard (platform setup only)
helpShow child attributes
article_idHelp registry category/slug
blocked_reasonShow child attributes
codemessage
wait_lineOptional, localized like line. On the utility's review step (documents) until approval: how long the platform's review usually takes. Present only when the server has a figure: the median of past decided reviews once there are at least 3, else the configured onboarding.review_wait (default 0, meaning absent).
doorsThe two resident entry doors (public entry only)
Show child attributes
idtitlelinehelpShow child attributes
article_id
actionsPublic utility lookup and request-status actions (public entry only)
Show child attributes
idtitlelinehelpShow child attributes
article_id
run_tokenOpaque run token for a staff journey or the anonymous resident entry
curl -X GET "$CONSUMER_API/next-steps" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$CONSUMER_API/next-steps", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$CONSUMER_API/next-steps",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$CONSUMER_API/next-steps", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"audience": "platform",
"locale": "pt-MZ",
"generated_at": "2026-11-19T09:30:00Z",
"steps": [
{
"id": "customer_import",
"journey_id": "utility_real",
"title": "Fuga na Rua 3",
"line": "line",
"state": "todo",
"owner": "you",
"action": {
"id": "utility.real.customer_import",
"label": "label",
"route": "/platform/settings/branding"
},
"help": {
"article_id": "getting-started/import-customers"
},
"blocked_reason": {
"code": "review_pending",
"message": "Leitura confirmada no local."
},
"wait_line": "A revisão costuma demorar cerca de 2 dias."
}
],
"doors": [
{
"id": "resident.link-existing-account",
"title": "Fuga na Rua 3",
"line": "line",
"help": {
"article_id": "residents/link-resident-account"
}
}
],
"actions": [
{
"id": "resident.link-existing-account",
"title": "Fuga na Rua 3",
"line": "line",
"help": {
"article_id": "residents/link-resident-account"
}
}
],
"run_token": "run token"
}