curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/activities/act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs/actions \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const actions = await fetch(
`https://api.kwugwo.africa/v1/ugwo/${ugwoUid}/activities/${activityUid}/actions`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
import os, requests
actions = requests.get(
f"https://api.kwugwo.africa/v1/ugwo/{ugwo_uid}/activities/{activity_uid}/actions",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/ugwo/{$ugwoUid}/activities/{$activityUid}/actions");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$actions = json_decode(curl_exec($ch), true);
curl_close($ch);
[
{
"uid": "uac.VCvr.Hn2pLw8QxTzRb4KdYs6VmAcE",
"action": { "type": "input_pin" },
"status": "fulfilled",
"last_error": null,
"expires_at": "2026-08-12T10:34:11+00:00",
"created_at": "2026-08-12T10:24:02+00:00",
"updated_at": "2026-08-12T10:24:40+00:00"
},
{
"uid": "uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU",
"action": { "type": "input_otp", "supports_resend": true },
"status": "pending",
"last_error": null,
"expires_at": "2026-08-12T10:34:41+00:00",
"created_at": "2026-08-12T10:24:41+00:00",
"updated_at": "2026-08-12T10:24:41+00:00"
}
]
{
"code": 404,
"message": "nzube.ugwo.ugwo_activity.error.not_found"
}
Next actions
List next actions
Every next action an activity has gone through, current one included.
GET
/
v1
/
ugwo
/
{ugwoUid}
/
activities
/
{activityUid}
/
actions
curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/activities/act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs/actions \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const actions = await fetch(
`https://api.kwugwo.africa/v1/ugwo/${ugwoUid}/activities/${activityUid}/actions`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
import os, requests
actions = requests.get(
f"https://api.kwugwo.africa/v1/ugwo/{ugwo_uid}/activities/{activity_uid}/actions",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/ugwo/{$ugwoUid}/activities/{$activityUid}/actions");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$actions = json_decode(curl_exec($ch), true);
curl_close($ch);
[
{
"uid": "uac.VCvr.Hn2pLw8QxTzRb4KdYs6VmAcE",
"action": { "type": "input_pin" },
"status": "fulfilled",
"last_error": null,
"expires_at": "2026-08-12T10:34:11+00:00",
"created_at": "2026-08-12T10:24:02+00:00",
"updated_at": "2026-08-12T10:24:40+00:00"
},
{
"uid": "uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU",
"action": { "type": "input_otp", "supports_resend": true },
"status": "pending",
"last_error": null,
"expires_at": "2026-08-12T10:34:41+00:00",
"created_at": "2026-08-12T10:24:41+00:00",
"updated_at": "2026-08-12T10:24:41+00:00"
}
]
{
"code": 404,
"message": "nzube.ugwo.ugwo_activity.error.not_found"
}
Returns all next actions created for the
activity. Order is not guaranteed; sort by
created_at if you need a
timeline. Most activities have one; an
activity that walks the customer through several steps (for example
input_pin then input_otp) has one per step. The current step is
also on the activity as next_action.
This endpoint is not paginated: it returns a plain array.
Path parameters
string
required
The ugwo ID,
ugw.XXXX.YYYY....string
required
The activity ID,
act.XXXX.YYYY.... Must belong to the ugwo.Response
An array of Next action objects.curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/activities/act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs/actions \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const actions = await fetch(
`https://api.kwugwo.africa/v1/ugwo/${ugwoUid}/activities/${activityUid}/actions`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
import os, requests
actions = requests.get(
f"https://api.kwugwo.africa/v1/ugwo/{ugwo_uid}/activities/{activity_uid}/actions",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/ugwo/{$ugwoUid}/activities/{$activityUid}/actions");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
]);
$actions = json_decode(curl_exec($ch), true);
curl_close($ch);
[
{
"uid": "uac.VCvr.Hn2pLw8QxTzRb4KdYs6VmAcE",
"action": { "type": "input_pin" },
"status": "fulfilled",
"last_error": null,
"expires_at": "2026-08-12T10:34:11+00:00",
"created_at": "2026-08-12T10:24:02+00:00",
"updated_at": "2026-08-12T10:24:40+00:00"
},
{
"uid": "uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU",
"action": { "type": "input_otp", "supports_resend": true },
"status": "pending",
"last_error": null,
"expires_at": "2026-08-12T10:34:41+00:00",
"created_at": "2026-08-12T10:24:41+00:00",
"updated_at": "2026-08-12T10:24:41+00:00"
}
]
{
"code": 404,
"message": "nzube.ugwo.ugwo_activity.error.not_found"
}