> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwugwo.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# List next actions

> Every next action an activity has gone through, current one included.

Returns all [next actions](https://docs.kwugwo.africa/ugwo/next-action-object.md) 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

**ugwoUid** `string` *required*

The ugwo ID, `ugw.XXXX.YYYY...`.

**activityUid** `string` *required*

The activity ID, `act.XXXX.YYYY...`. Must belong to the ugwo.

## Response

An array of [Next action objects](https://docs.kwugwo.africa/ugwo/next-action-object.md).

```bash cURL theme={"system"}
curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE/activities/act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs/actions \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY"
```

```js Node theme={"system"}
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());
```

```python Python theme={"system"}
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 PHP theme={"system"}
<?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);
```

```json 200 OK theme={"system"}
[
  {
    "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"
  }
]
```

```json 404 Not Found theme={"system"}
{
  "code": 404,
  "message": "nzube.ugwo.ugwo_activity.error.not_found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.