Usage Info

Retrieve comprehensive details of a Business Owner entity including the Person entity associated with the Business Owner.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

Parameter	Type	Required	Description
business_owner_id	string	Yes	The identifier for the Business Owner entity.
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_owner_id": "bo_7eobHllxknr7mfqbjnX2Pp",
  "show_sensitive_data": true, 
  "verbose": true
}

Response

Data

Parameter	Type	Description
business_owner	object	The business_owner info parameter is defined in the table below.

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_owner": {
      "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"
    }
  }
}

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": "******999",
        "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_owner_id` provided does not exist.