curl -G https://api.kwugwo.africa/v1/onye \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
--data-urlencode "limit=50"
const page = await fetch("https://api.kwugwo.africa/v1/onye?limit=50", {
headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
}).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/onye?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/onye",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
params={"limit": 50},
).json()
req, _ := http.NewRequest("GET", "https://api.kwugwo.africa/v1/onye?limit=50", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
{
"items": [
{
"uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Okeke",
"nzube_ref": "user_8821",
"billing_address": {
"address": "12 Marina",
"address2": "",
"city": "Lagos",
"state": "Lagos",
"zip": "101001",
"country": "NG"
},
"created_at": "2026-05-15T09:14:22+00:00",
"updated_at": "2026-05-15T09:14:22+00:00",
"meta": { "source": "shopify" },
"total_successful_activities": 0,
"total_failed_activities": 0,
"latest_ugwo_activity": null
}
],
"pagination": {
"next_cursor": "Xc7qL2mA",
"prev_cursor": null
}
}
Customers (Onye)
List customers
Page through customers on your workspace, newest first.
GET
/
v1
/
onye
curl -G https://api.kwugwo.africa/v1/onye \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
--data-urlencode "limit=50"
const page = await fetch("https://api.kwugwo.africa/v1/onye?limit=50", {
headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
}).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/onye?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/onye",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
params={"limit": 50},
).json()
req, _ := http.NewRequest("GET", "https://api.kwugwo.africa/v1/onye?limit=50", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
{
"items": [
{
"uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Okeke",
"nzube_ref": "user_8821",
"billing_address": {
"address": "12 Marina",
"address2": "",
"city": "Lagos",
"state": "Lagos",
"zip": "101001",
"country": "NG"
},
"created_at": "2026-05-15T09:14:22+00:00",
"updated_at": "2026-05-15T09:14:22+00:00",
"meta": { "source": "shopify" },
"total_successful_activities": 0,
"total_failed_activities": 0,
"latest_ugwo_activity": null
}
],
"pagination": {
"next_cursor": "Xc7qL2mA",
"prev_cursor": null
}
}
Returns a cursor-paginated list of customers, newest
first. Deleted customers are excluded.
Query parameters
integer
default:"10"
Page size,
1 to 100.string
A
next_cursor or prev_cursor from a previous page.Response
Customer[]
Customer objects.
latest_ugwo_activity is an
activity ID.object
curl -G https://api.kwugwo.africa/v1/onye \
-H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
--data-urlencode "limit=50"
const page = await fetch("https://api.kwugwo.africa/v1/onye?limit=50", {
headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
}).then(r => r.json());
<?php
$ch = curl_init("https://api.kwugwo.africa/v1/onye?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/onye",
headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
params={"limit": 50},
).json()
req, _ := http.NewRequest("GET", "https://api.kwugwo.africa/v1/onye?limit=50", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KWUGWO_SECRET_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
{
"items": [
{
"uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Okeke",
"nzube_ref": "user_8821",
"billing_address": {
"address": "12 Marina",
"address2": "",
"city": "Lagos",
"state": "Lagos",
"zip": "101001",
"country": "NG"
},
"created_at": "2026-05-15T09:14:22+00:00",
"updated_at": "2026-05-15T09:14:22+00:00",
"meta": { "source": "shopify" },
"total_successful_activities": 0,
"total_failed_activities": 0,
"latest_ugwo_activity": null
}
],
"pagination": {
"next_cursor": "Xc7qL2mA",
"prev_cursor": null
}
}