v1

latestOpenAPI 3.1.02026-07-26590236.8 KB

List UBOs

get/business/{business_id}/ubo

Path parameters

business_idstring required

Query parameters

include'person'

Response

200

messagestring

{"stackTrail":"paths:/business/{business_id}/ubo:get:responses:200:content:application/json:schema:properties:meta","oasType":"schema","type":"unknown"}

statusstring

Example response

{
  "data": [
    {
      "id": "4af1c18b-6fea-11f0-97d0-0edb5e3a61d3",
      "person_id": "2c0090a9bd5511ef97d00edb5e3a61d3",
      "business_id": "c80c60176fa711f097d00edb5e3a61d3",
      "share": 25.24,
      "created_at": "2025-08-02T21:47:31Z",
      "updated_at": "2025-08-02T21:47:31Z",
      "person": {
        "id": "2c0090a9bd5511ef97d00edb5e3a61d3",
        "name_first": "wabi",
        "name_last": "sabi",
        "name_other": "sample",
        "email": "kevin@sample.io",
        "phone": "23400000000",
        "dob": "1989-01-14T00:00:00Z",
        "id_level": "primary",
        "id_type": "passport",
        "id_number": "B00000000",
        "id_country": "NG",
        "bank_id_number": "22333333312",
        "bank_id_type": "bvn",
        "address": {
          "line1": "44 Marka Close",
          "city": "Ikeja",
          "state": "Lagos",
          "country": "NG",
          "postal_code": "100212"
        },
        "background_information": {
          "employment_status": "employed",
          "expected_monthly_inflow": 500000,
          "occupation": "engineer",
          "primary_purpose": "personal",
          "source_of_funds": "salary"
        },
        "status": "active",
        "kyc_status": "verified",
        "kyc_level": "basic",
        "created_at": "2024-12-18T15:31:37Z",
        "updated_at": "2024-12-18T15:31:37Z"
      }
    }
  ],
  "message": "Business UBOs retrieved successfully",
  "status": "success"
}