Skip to main content
GET
/
v1
/
ugwo
/
{ugwoUid}
curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY"

{
  "uid": "ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
  "amount": 500000,
  "currency": "NGN",
  "status": "ugwo_successful",
  "ref": "order_4719",
  "description": "Order #4719",
  "metadata": { "order_id": "4719" },
  "onye": {
    "uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
    "email": "ada@example.com"
  },
  "checkout": null,
  "activities": [
    {
      "uid": "act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs",
      "activity_type": "charge",
      "status": "requires_action",
      "psp": "paystack_ng",
      "psp_external_id": "5kfxw34ugz",
      "next_action": {
        "type": "user_action",
        "instruction": "Transfer to bank",
        "headers": {
          "bank_name": "Test Bank",
          "expires_at": "2026-05-14T20:10:50+00:00",
          "account_name": "PAYSTACK CHECKOUT",
          "account_number": "1260881821"
        }
      },
      "error": null,
      "created_at": "2026-05-14T19:55:50+00:00",
      "updated_at": "2026-05-14T19:55:51+00:00"
    }
  ],
  "created_at": "2026-05-15T09:14:22+00:00"
}

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.

Returns the ugwo identified by ugwoUid. The response includes the attached customer, checkout (if any), and the activities that have been run against it.

​
Path parameters

​
ugwoUid
string
required
The ugwo ID — ugw.XXXX.YYYY....

​
Response

Same shape as the create response, plus an activities array of every activity that has run against this ugwo. 
curl https://api.kwugwo.africa/v1/ugwo/ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE \
  -H "Authorization: Bearer $KWUGWO_SECRET_KEY"

{
  "uid": "ugw.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
  "amount": 500000,
  "currency": "NGN",
  "status": "ugwo_successful",
  "ref": "order_4719",
  "description": "Order #4719",
  "metadata": { "order_id": "4719" },
  "onye": {
    "uid": "ony.VCvr.7K2qPmRtV9xLnQ8sD1cYwHfE",
    "email": "ada@example.com"
  },
  "checkout": null,
  "activities": [
    {
      "uid": "act.VCvr.qnbBJaElzSTHOcaTzxbuDlIs",
      "activity_type": "charge",
      "status": "requires_action",
      "psp": "paystack_ng",
      "psp_external_id": "5kfxw34ugz",
      "next_action": {
        "type": "user_action",
        "instruction": "Transfer to bank",
        "headers": {
          "bank_name": "Test Bank",
          "expires_at": "2026-05-14T20:10:50+00:00",
          "account_name": "PAYSTACK CHECKOUT",
          "account_number": "1260881821"
        }
      },
      "error": null,
      "created_at": "2026-05-14T19:55:50+00:00",
      "updated_at": "2026-05-14T19:55:51+00:00"
    }
  ],
  "created_at": "2026-05-15T09:14:22+00:00"
}