v1

latestOpenAPI 3.1.02026-07-26590236.8 KB

Fetch UBO

get/business/{business_id}/ubo/{ubo_id}

Path parameters

business_idstring required

ubo_idstring required

Query parameters

include'person'

Response

200

messagestring

{"stackTrail":"paths:/business/{business_id}/ubo/{ubo_id}: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 UBO retrieved successfully",
  "status": "success"
}