curl -G https://api.kwugwo.africa/v1/refunds \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY" \
  --data-urlencode "limit=20" \
  --data-urlencode "filters[ugwo]=ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE" \
  --data-urlencode "filters[status][]=successful" \
  --data-urlencode "filters[status][]=failed"

const params = new URLSearchParams({
  limit: "20",
  "filters[ugwo_activity]": activityUid,
});

const page = await fetch(`https://api.kwugwo.africa/v1/refunds?${params}`, {
  headers: { Authorization: `Bearer ${process.env.KWUGWO_SECRET_KEY}` },
}).then(r => r.json());

const alreadyRefunded = page.items.some(r => r.ref === `${orderId}_refund_1`);

<?php
$query = http_build_query([
    'limit'   => 20,
    'filters' => ['ugwo_activity' => $activityUid],
]);

$ch = curl_init("https://api.kwugwo.africa/v1/refunds?{$query}");
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/refunds",
    headers={"Authorization": f"Bearer {os.environ['KWUGWO_SECRET_KEY']}"},
    params={
        "limit": 20,
        "filters[ugwo_activity]": activity_uid,
        "filters[status][]": ["successful", "failed"],
    },
).json()

for refund in page["items"]:
    print(refund["uid"], refund["status"], refund["amount"])

q := url.Values{}
q.Set("limit", "20")
q.Set("filters[ugwo_activity]", activityUid)

req, _ := http.NewRequest("GET", "https://api.kwugwo.africa/v1/refunds?"+q.Encode(), 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))

{
  "items": [
    {
      "uid": "rfd.VCvr.Hs7dQmXk2LpRvN9tYbCwZaEf",
      "psp_external_ref": "3018284",
      "ref": "order_4719_refund_1",
      "reason": "Customer returned the notebook",
      "amount": 200000,
      "status": "successful",
      "error": null,
      "created_at": "2026-08-12T10:04:11+00:00",
      "updated_at": "2026-08-12T14:31:07+00:00",
      "ugwo": {
        "uid": "ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
        "currency": "NGN"
      },
      "ugwo_activity": {
        "uid": "act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs",
        "activity_type": "charge",
        "status": "partially_refunded",
        "psp": "paystack_ng",
        "psp_external_id": "5kfxw34ugz",
        "amount": 500000,
        "charged_amount": 500000,
        "refunded_amount": 200000,
        "error": null,
        "created_at": "2026-08-11T19:55:50+00:00",
        "updated_at": "2026-08-12T10:04:11+00:00"
      },
      "nzube_psp": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}

{
  "type": "validation.error",
  "title": "An error occurred",
  "status": 422,
  "detail": "One or more of the given values is invalid.",
  "message": "Validation failed",
  "errors": [
    { "field": "filters[status]", "message": "One or more of the given values is invalid." }
  ]
}