> ## 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 ugwos

> Page through payment requests on this workspace.

Returns a [cursor-paginated](/pagination) list of ugwos belonging to
the workspace that owns the secret key, newest first.

## Query parameters

<ParamField query="cursor" type="string">
  Cursor returned by the previous page's `next_cursor`.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  Page size, between `1` and `100`.
</ParamField>

## Response

<ResponseField name="data" type="Ugwo[]">
  Page of ugwos. Each item matches the [Create
  response](/ugwo/create#response).
</ResponseField>

<ResponseField name="next_cursor" type="string | null">
  Pass to the next request, or `null` on the last page.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.kwugwo.africa/v1/ugwo \
    -H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
    --data-urlencode "limit=50"
  ```

  ```js Node theme={null}
  const params = new URLSearchParams({ limit: "50" });
  const res = await fetch(`https://api.kwugwo.africa/v1/ugwo?${params}`, {
    headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
  });
  const page = await res.json();
  ```

  ```php PHP theme={null}
  <?php
  $ch = curl_init("https://api.kwugwo.africa/v1/ugwo?limit=50");
  curl_setopt_array($ch, [
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('KWUGWO_SECRET_KEY')],
  ]);
  $page = json_decode(curl_exec($ch), true);
  curl_close($ch);
  ```

  ```python Python theme={null}
  import os, requests

  page = requests.get(
      "https://api.kwugwo.africa/v1/ugwo",
      headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
      params={"limit": 50},
  ).json()
  ```

  ```go Go theme={null}
  req, _ := http.NewRequest("GET", "https://api.kwugwo.africa/v1/ugwo?limit=50", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "uid": "ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
        "amount": 500000,
        "currency": "NGN",
        "status": "ugwo_successful",
        "ref": "order_4719",
        "created_at": "2026-05-15T09:14:22+00:00"
      }
    ],
    "next_cursor": "eyJpZCI6MTIzfQ=="
  }
  ```
</ResponseExample>