Skip to main content
GET
/
v1
/
entities
/
{id}
/
family
Entity Family
curl --request GET \
  --url https://api.signa.so/v1/entities/{id}/family \
  --header 'Authorization: Bearer <token>'
{
  "object": "entity_family",
  "parent": {
    "id": "ent_parentAB",
    "object": "entity",
    "name": "8x8 Holdings",
    "country_code": "US",
    "relationship": "parent",
    "source": "gleif"
  },
  "children": [
    {
      "id": "ent_childEMEA",
      "object": "entity",
      "name": "8x8 EMEA Ltd",
      "country_code": "GB",
      "relationship": "direct_subsidiary",
      "source": "gleif"
    }
  ],
  "source": "gleif",
  "coverage_caveat": "Family edges are sourced from GLEIF Level 2 (IS_DIRECTLY_CONSOLIDATED_BY) and cover LEI-reporting companies only. An absent edge does not imply the absence of a corporate relationship.",
  "request_id": "req_xyz789"
}

​
Overview

Returns the GLEIF-curated direct family of an entity: its corporate parent and its direct subsidiaries, one level deep. This is the curated, direct-consolidation view of corporate structure — distinct from the raw, all-relationship-types graph at Owner Related. Family edges come from GLEIF Level 2 (the IS_DIRECTLY_CONSOLIDATED_BY relationship). Coverage is therefore limited to LEI-reporting companies — an absent edge does not mean the entity has no parent or subsidiaries, only that none is recorded in GLEIF. A derived singleton, or a materialized entity with no GLEIF edges, returns { parent: null, children: [] } (a valid 200, not a 404).
“Family” is a group-level relationship — related companies in a corporate tree. It is never an identity claim: Pfizer Inc (US) and Pfizer AG (CH) are distinct entities connected by family, not the same entity.

​
Path Parameters

​
id
string
required
Entity ID (e.g. ent_R3jK9mN2), including the derived ent_<owner-uuid> form.

​
Response

​
object
string
Always entity_family.
​
parent
object | null
The corporate parent, or null when none is recorded.
​
children
object[]
Direct subsidiaries, sorted by name. Each carries relationship: "direct_subsidiary" and source: "gleif".
​
source
string
Always gleif.
​
coverage_caveat
string
A human-readable note that edges are GLEIF Level 2 and cover LEI-reporting companies only.
​
request_id
string
Unique request identifier for support.
{
  "object": "entity_family",
  "parent": {
    "id": "ent_parentAB",
    "object": "entity",
    "name": "8x8 Holdings",
    "country_code": "US",
    "relationship": "parent",
    "source": "gleif"
  },
  "children": [
    {
      "id": "ent_childEMEA",
      "object": "entity",
      "name": "8x8 EMEA Ltd",
      "country_code": "GB",
      "relationship": "direct_subsidiary",
      "source": "gleif"
    }
  ],
  "source": "gleif",
  "coverage_caveat": "Family edges are sourced from GLEIF Level 2 (IS_DIRECTLY_CONSOLIDATED_BY) and cover LEI-reporting companies only. An absent edge does not imply the absence of a corporate relationship.",
  "request_id": "req_xyz789"
}

​
Code Examples

curl "https://api.signa.so/v1/entities/ent_R3jK9mN2/family" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE"
To list trademarks across the whole corporate group (parent + all descendants), use the entity_group filter on List Trademarks — GET /v1/trademarks?entity_group=ent_....

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks the trademarks:read scope
404not_foundEntity ID does not exist (or a derived id for a suppressed / merged-away owner)
410entity_mergedThe entity was fused into another; follow merged_into