Skip to main content
GET
/
v1
/
ugwo
curl -G https://api.kwugwo.africa/v1/ugwo \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
  --data-urlencode "limit=50"
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
$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);
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()
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))
{
  "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=="
}
Returns a cursor-paginated list of ugwos belonging to the workspace that owns the secret key, newest first.

Query parameters

cursor
string
Cursor returned by the previous page’s next_cursor.
limit
integer
default:"10"
Page size, between 1 and 100.

Response

data
Ugwo[]
Page of ugwos. Each item matches the Create response.
next_cursor
string | null
Pass to the next request, or null on the last page.
curl -G https://api.kwugwo.africa/v1/ugwo \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
  --data-urlencode "limit=50"
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
$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);
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()
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))
{
  "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=="
}