increase-test
GET/entity_beneficial_owners/{entity_beneficial_owner_id}

Retrieve a beneficial owner

Retrieves a beneficial owner associated with a corporation entity. Use the beneficial owner identifier to inspect the individual's personal details and the reasons they qualify as a beneficial owner.

1 parameter
entity_beneficial_owner_idstringrequired
The identifier of the beneficial owner to retrieve.

3 status codes
200Returns the beneficial owner, including its identifier, associated entity, personal details, qualifying reasons, and creation time.
company_titlestringrequired
This person's role or title within the entity.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Beneficial Owner was created.
entity_idstringrequired
The identifier of the Entity to which this beneficial owner belongs.
idstringrequired
The identifier of this beneficial owner.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
individualobjectrequired
Personal details for the beneficial owner.
prongsarray<string>required
Why this person is considered a beneficial owner of the entity.
typestringrequired
A constant representing the object's type. For this resource it will always be `entity_beneficial_owner`.
Allowed:entity_beneficial_owner
4XXReturned when the request encounters a client-side error.
5XXReturned when the server encounters an error.

Error handling

The entity_beneficial_owner_id path parameter must identify an existing beneficial owner.