curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/activities/act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs/actions/uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const action = await fetch(
`https://api.kwugwo.africa/v1/ugwo/${ugwoUid}/activities/${activityUid}/actions/${actionUid}`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
import os, requests
action = requests.get(
f"https://api.kwugwo.africa/v1/ugwo/{ugwo_uid}/activities/{activity_uid}/actions/{action_uid}",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
{
"uid": "uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU",
"action": {
"type": "user_action",
"instruction": "Transfer to bank",
"headers": {
"bank_name": "Test Bank",
"account_number": "1260881821",
"account_name": "PAYSTACK CHECKOUT",
"expires_at": "2026-05-14T20:10:50+00:00"
}
},
"status": "fulfilled",
"last_error": null,
"expires_at": "2026-05-14T20:10:50+00:00",
"created_at": "2026-05-14T19:55:51+00:00",
"updated_at": "2026-05-14T20:01:12+00:00"
}
{
"code": 404,
"message": "nzube.ugwo.ugwo_activity.next_action.error.not_found"
}
Next actions
Get a next action
Fetch a single next action by ID.
GET
/
v1
/
ugwo
/
{ugwoUid}
/
activities
/
{activityUid}
/
actions
/
{actionUid}
curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/activities/act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs/actions/uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const action = await fetch(
`https://api.kwugwo.africa/v1/ugwo/${ugwoUid}/activities/${activityUid}/actions/${actionUid}`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
import os, requests
action = requests.get(
f"https://api.kwugwo.africa/v1/ugwo/{ugwo_uid}/activities/{activity_uid}/actions/{action_uid}",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
{
"uid": "uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU",
"action": {
"type": "user_action",
"instruction": "Transfer to bank",
"headers": {
"bank_name": "Test Bank",
"account_number": "1260881821",
"account_name": "PAYSTACK CHECKOUT",
"expires_at": "2026-05-14T20:10:50+00:00"
}
},
"status": "fulfilled",
"last_error": null,
"expires_at": "2026-05-14T20:10:50+00:00",
"created_at": "2026-05-14T19:55:51+00:00",
"updated_at": "2026-05-14T20:01:12+00:00"
}
{
"code": 404,
"message": "nzube.ugwo.ugwo_activity.next_action.error.not_found"
}
Returns one next action. Useful after a
ugwo.activity.next_action.* webhook, which carries the action’s
uid but not its activity: keep the activity and ugwo IDs you got
when you created the activity.
Path parameters
string
required
The ugwo ID,
ugw.XXXX.YYYY....string
required
The activity ID,
act.XXXX.YYYY....string
required
The next action ID,
uac.XXXX.YYYY.... Must belong to the activity.Response
A Next action object.curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/activities/act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs/actions/uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY"
const action = await fetch(
`https://api.kwugwo.africa/v1/ugwo/${ugwoUid}/activities/${activityUid}/actions/${actionUid}`,
{ headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` } }
).then(r => r.json());
import os, requests
action = requests.get(
f"https://api.kwugwo.africa/v1/ugwo/{ugwo_uid}/activities/{activity_uid}/actions/{action_uid}",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
).json()
{
"uid": "uac.VCvr.Rk4mZpQ7wLsD2vT8xNbHyCeU",
"action": {
"type": "user_action",
"instruction": "Transfer to bank",
"headers": {
"bank_name": "Test Bank",
"account_number": "1260881821",
"account_name": "PAYSTACK CHECKOUT",
"expires_at": "2026-05-14T20:10:50+00:00"
}
},
"status": "fulfilled",
"last_error": null,
"expires_at": "2026-05-14T20:10:50+00:00",
"created_at": "2026-05-14T19:55:51+00:00",
"updated_at": "2026-05-14T20:01:12+00:00"
}
{
"code": 404,
"message": "nzube.ugwo.ugwo_activity.next_action.error.not_found"
}