> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Owner Related Entities

> Find entities related to an owner through corporate structure

## Overview

Returns entities related to the specified owner. Relationships are primarily sourced from GLEIF Level 2 corporate parent/subsidiary data. Use this for M\&A due diligence, corporate family mapping, and understanding ownership structures behind trademark portfolios.

## Path Parameters

<ParamField path="id" type="string" required>
  Owner ID (e.g., `own_Rj3kL9mN`)
</ParamField>

## Query Parameters

<ParamField query="direction" type="string">
  Filter by relationship direction: `parent` or `child`. Omit to return both.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Items per page (max 100)
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from previous response
</ParamField>

## Response

<ResponseField name="data" type="object[]">
  <Expandable title="Related entity object (flat structure)">
    <ResponseField name="related_owner_id" type="string">Owner ID of the related entity (`own_*`)</ResponseField>
    <ResponseField name="name" type="string">Name of the related entity</ResponseField>
    <ResponseField name="country_code" type="string">ISO country code</ResponseField>
    <ResponseField name="relationship_type" type="string">GLEIF relationship type (e.g., `IS_DIRECTLY_CONSOLIDATED_BY`)</ResponseField>
    <ResponseField name="relationship_status" type="string">Relationship status (e.g., `ACTIVE`)</ResponseField>
    <ResponseField name="ownership_pct" type="number">Ownership percentage (may be null)</ResponseField>
    <ResponseField name="period_start" type="string">ISO date when the relationship started</ResponseField>
    <ResponseField name="period_end" type="string">ISO date when the relationship ended (null if current)</ResponseField>
    <ResponseField name="direction" type="string">`parent` or `child`</ResponseField>
    <ResponseField name="source" type="string">Data source (e.g., `gleif_level2`)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "related_owner_id": "own_Tk5nM7pQ",
        "name": "Aurora Holdings Corp.",
        "country_code": "US",
        "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",
        "relationship_status": "ACTIVE",
        "ownership_pct": null,
        "period_start": "2020-01-15",
        "period_end": null,
        "direction": "parent",
        "source": "gleif_level2"
      },
      {
        "related_owner_id": "own_Vm8pN3qR",
        "name": "Aurora Digital GmbH",
        "country_code": "DE",
        "relationship_type": "IS_DIRECTLY_CONSOLIDATED_BY",
        "relationship_status": "ACTIVE",
        "ownership_pct": null,
        "period_start": "2018-06-01",
        "period_end": null,
        "direction": "child",
        "source": "gleif_level2"
      }
    ],
    "has_more": false,
    "pagination": {
      "cursor": null
    },
    "request_id": "req_gZ6qR2sT"
  }
  ```
</ResponseExample>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/owners/own_Rj3kL9mN/related?direction=parent" \
    -H "Authorization: Bearer sig_xxxxxxxxxxxx"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";

  const signa = new Signa({ api_key: "sig_xxxxxxxxxxxx" });

  const related = await signa.owners.related("own_Rj3kL9mN", {
    direction: "parent",
  });
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.signa.so/v1/owners/own_Rj3kL9mN/related",
      headers={"Authorization": "Bearer sig_xxxxxxxxxxxx"},
      params={"direction": "parent"},
  )
  related = resp.json()["data"]
  ```
</CodeGroup>

## Errors

| Status | Type               | Description                |
| ------ | ------------------ | -------------------------- |
| 400    | `validation_error` | Invalid `direction` value  |
| 401    | `unauthorized`     | Missing or invalid API key |
| 404    | `not_found`        | Owner ID does not exist    |
| 429    | `rate_limited`     | Too many requests          |

## Related Endpoints

* [Get Owner](/api-reference/parties/get-owner) -- owner profile and stats
* [Owner Trademarks](/api-reference/parties/owner-trademarks) -- marks owned by this entity
* [Get Trademark](/api-reference/trademarks/get-trademark) -- individual trademark detail