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=="
}
Payments (Ugwo)
List ugwos
Page through payment requests on this workspace.
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 returned by the previous page’s
next_cursor.Page size, between
1 and 100.Response
Page of ugwos. Each item matches the Create
response.
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=="
}
⌘I

