Skip to main content
GET
/
v1
/
owners
/
{id}
/
related
Owner Related Entities
curl --request GET \
  --url https://api.example.com/v1/owners/{id}/related
{
  "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
  },
  "livemode": true,
  "request_id": "req_gZ6qR2sT"
}

​
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

​
id
string
required
Owner ID (e.g., own_Rj3kL9mN)

​
Query Parameters

​
direction
string
Filter by relationship direction: parent or child. Omit to return both.
​
limit
integer
default:"20"
Items per page (max 100)
​
cursor
string
Pagination cursor from previous response

​
Response

​
data
object[]
{
  "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
  },
  "livemode": true,
  "request_id": "req_gZ6qR2sT"
}

​
Code Examples

curl "https://api.signa.so/v1/owners/own_Rj3kL9mN/related?direction=parent" \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorInvalid direction value
401unauthorizedMissing or invalid API key
404not_foundOwner ID does not exist
429rate_limitedToo many requests