Retrieve a comprehensive list of all owners associated with a specific Business entity.

POST http://api.kompliant.com/business.listOwners (OpenAPI specification)

Usage Info

This method returns all ownership relationships for a specific Business, including detailed information about each owner such as ownership type, percentage, position, and when the ownership was established. Use this method when displaying ownership structures, verifying beneficial ownership for compliance purposes, or reviewing stakeholder information during decision processes.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

Parameter	Type	Required	Description
business_id	string	Yes	The identifier for the Business from which to list all the Business Owner objects.
show_sensitive_data	boolean	No	A boolean value that if `true`, indicates that sensitive data should shown. If the parameter is not provided, the value defaults to `false` and the sensitive data will be masked. The sensitive data for the `business owner` is dependant on the sub entity `person`
verbose	boolean	No	A boolean value that when `true` includes the sub entities of the subject record in the response. The sub entity is `person`

Example

{
  "business_id": "b_7eobHllxknr7mfqbjnX2Pp",
  "show_sensitive_data": true, 
  "verbose": true
}

Response

Data

Parameter	Type	Description
business_owners	array	An array of business owner objects that contain information about Business Owners within the Business. If the Business has no Business Owners objects, the array will be empty.

Business Owner Parameters

Parameter	Type	Description
business_owner_id	string	The ID of the Business Owner.
person_id	string	The Person that is an owner of business.
ownership_type	string	The type of ownership the person has over the business. Must be one of the BUSINESS_OWNERSHIP_TYPES.
ownership_percentage	integer	The amount of ownership the person has over the business. The range of allowed values is 0 to 100.
ownership_year_month	string	The month and year when the person first obtained significant ownership in the business. This must be in the YYYY-MM format and contain only digits [0-9] and dashes.
business_person_position	string	The position the person has within the business. Must be one of the BUSINESS_PERSON_POSITIONS .
person	object	An Object containing the Person entity information Requires verbose to be `true` to be displayed.
created_at	string	The date-time when the Business Owner was created. The value will be in ISO 8601 date and time format (YYYY-MM-DDTHH:mm:ss.SSSZ).
updated_at	string	The date-time when the Business Owner was last updated. If there has been no update, the value will be the same as the created_at value. The value will be in ISO 8601 date and time format (YYYY-MM-DDTHH:mm:ss.SSSZ).

Example

{
  "meta": {
    "status": "SUCCESS",
    "trace_id": "trc_2h1MG0xRq9dPAPWLuygFk5",
    "version": "2025-03-24"
  },
  "data": {
    "business_owners": [
      {
        "business_owner_id": "bo_5nCWRq51h3ILIJvOOhfF4i",
        "person_id": "p_4PYsekjAX8VMuAOfmW81C7",
        "ownership_type": "CONTROL_PRONG",
        "ownership_percentage": 45,
        "ownership_year_month": "2023-11",
        "business_person_position": "PRESIDENT",
        "created_at": "2025-01-17T22:45:38.206Z",
        "updated_at": "2025-01-17T22:45:38.206Z"
      },
      {
        "business_owner_id": "bo_7kRdsUOdLaYDtZQDm5aVmP",
        "person_id": "p_3wmeA2fMPq8L8jbPMDvWrl",
        "ownership_type": "OWNERSHIP_PRONG",
        "ownership_percentage": 55,
        "ownership_year_month": "2018-03",
        "business_person_position": "OWNER",
        "created_at": "2025-01-19T03:14:09.781Z",
        "updated_at": "2025-01-19T03:14:09.781Z"
      }
    ]
  }
}

Example with verbose

{
  "meta": {
    "status": "SUCCESS",
    "version": "2025-03-24",
    "trace_id": "trc_1aslBdgFDzXzxjC1iYz1ep"
  },
  "data": {
    "business_owners": [
      {
        "business_owner_id": "bo_392MhBslgD2jYcvCaqb0Hj",
        "person_id": "p_1FqatIQgqhleEsXFplt4OJ",
        "ownership_type": "CONTROL_PRONG",
        "ownership_percentage": 50,
        "ownership_year_month": "1990-03",
        "business_person_position": "PRESIDENT",
        "created_at": "2025-09-04T17:13:10.556Z",
        "updated_at": "2025-09-04T17:13:10.556Z",
        "person": {
          "person_id": "p_1FqatIQgqhleEsXFplt4OJ",
          "email": "[email protected]",
          "first_name": "Sarah",
          "last_name": "Johnson",
          "date_of_birth": "1990-10-10",
          "tax_id": "999999999",
          "citizenship": "US",
          "phone_number": "2345678901",
          "addresses": [
            {
              "type": "PRIMARY_RESIDENCE",
              "line1": "123 MAPLE AVENUE",
              "line2": "APARTMENT 4B",
              "city": "PORTLAND",
              "state": "OR",
              "postal_code": "97204",
              "country": "US"
            }
          ],
          "created_at": "2025-09-04T17:13:07.746Z",
          "updated_at": "2025-09-04T17:13:07.746Z"
        }
      }
    ]
  }
}

Errors

Error Code	HTTP Code	Possible Cause
BAD_REQUEST	400	Required parameters not provided. Invalid values provided.
ENTITY_NOT_FOUND	400	The `business_id` provided does not exist.