# Relationship

The `Relationship` object represents a connection between entities, such as officers, shareholders, or beneficial owners. The related entity is typically found in the parent entity's `counterparties` array.

## Fields

| Field                  | Type         | Description                                                |
| ---------------------- | ------------ | ---------------------------------------------------------- |
| `_parentId`            | string       | ID of the related entity (references a counterparty)       |
| `natureOfRelationship` | string       | See [Relationship Types](#relationship-types) below        |
| `role`                 | string       | Specific role title (e.g., `Director`, `Secretary`, `CEO`) |
| `shareholding`         | Shareholding | Ownership percentage details (for shareholders)            |

### Shareholding Object

| Field                                  | Type   | Description                                             |
| -------------------------------------- | ------ | ------------------------------------------------------- |
| `directShareholdingPercentageOwned`    | number | Exact ownership percentage                              |
| `minDirectShareholdingPercentageOwned` | number | Minimum ownership percentage (when a range is reported) |
| `maxDirectShareholdingPercentageOwned` | number | Maximum ownership percentage (when a range is reported) |

## Relationship Types

| Value              | Description                                     |
| ------------------ | ----------------------------------------------- |
| `Officer`          | Director, secretary, or other corporate officer |
| `Shareholder`      | Owner of shares in the entity                   |
| `Beneficial Owner` | Person with ultimate beneficial ownership       |
| `Auditor`          | Appointed auditor                               |
| `Liquidator`       | Appointed liquidator                            |
| `Representative`   | Legal or authorized representative              |
| `Member`           | Member of the entity (e.g., LLC members)        |

## Example

```json
{
  "_parentId": "counterparty-uuid",
  "natureOfRelationship": "Shareholder",
  "role": "Shareholder",
  "shareholding": {
    "directShareholdingPercentageOwned": 25.5
  }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://equinoxe-systems.gitbook.io/revolutio-api/data-models/relationship.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.