Get Business UBOs

Retrieve the list of Ultimate Beneficial Owners (UBOs) for a business customer owned by the authenticated partner.

Endpoint

GET https://prod.rynopay.io/partner/v1/business-profiles/{customerId}/ubos

Path parameters

Parameter	Type	Description
customerId	UUID	The business customer ID returned from Create Business Profile

Example request

curl -X GET https://prod.rynopay.io/partner/v1/business-profiles/a1b2c3d4-e5f6-7890-abcd-ef1234567890/ubos \
  -H "Authorization: Bearer <access_token>"

Response

200 OK

{
  "isSuccess": true,
  "value": {
    "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "businessProfileId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "ubos": [
      {
        "uboId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "firstName": "John",
        "lastName": "Doe",
        "birthDate": "1985-03-15",
        "email": "john.doe@acmecorp.com",
        "phone": "+2348012345678",
        "address": {
          "streetLine1": "12 Marina Road",
          "city": "Lagos",
          "state": "Lagos",
          "postalCode": "100001",
          "countryCode": "NGA"
        },
        "addressCountryIso3": "NGA",
        "ownershipType": ["SHAREHOLDER", "DIRECTOR"],
        "percentageShare": 45,
        "taxResidenceCountry": "NGA",
        "createdDateUtc": "2026-03-18T10:30:00Z"
      }
    ]
  }
}

Response fields

Field	Type	Description
customerId	string (UUID)	The business customer ID
businessProfileId	string (UUID)	The business profile ID
ubos	array	List of UBO objects

UBO object

Field	Type	Description
uboId	string (UUID)	Unique UBO identifier
firstName	string	First name
lastName	string	Last name
birthDate	string	Date of birth (YYYY-MM-DD)
email	string	Email address
phone	string	Phone number
address	object	Address object
addressCountryIso3	string	Address country (ISO 3166-1 alpha-3)
ownershipType	string[]	Ownership types (e.g. SHAREHOLDER, DIRECTOR, UBO)
percentageShare	integer	Ownership percentage
taxResidenceCountry	string	Tax residence country (ISO 3166-1 alpha-3)
createdDateUtc	string	Creation timestamp (ISO 8601)

400 Bad Request

{
  "isSuccess": false,
  "error": {
    "code": "Partner.NotAuthenticated",
    "message": "Partner ID could not be resolved"
  }
}