Skip to main content
GET
/
v1
/
entities
/
{id}
Get Entity
curl --request GET \
  --url https://api.signa.so/v1/entities/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "ent_R3jK9mN2",
  "object": "entity",
  "name": "8x8, Inc.",
  "country_code": "US",
  "entity_type": "corporation",
  "entity_id_type": "resolved",
  "publicly_traded": true,
  "ticker": "EGHT",
  "tickers": ["EGHT"],
  "lei": "5493001KQHV5W2NMMW07",
  "has_lei": true,
  "trademark_count": 214,
  "member_count": 2,
  "parent_entity_id": null,
  "members": [
    {
      "id": "own_uspto8x8",
      "object": "owner",
      "name": "8x8, Inc.",
      "canonical_name": "8X8 INC",
      "country_code": "US",
      "entity_type": "corporation",
      "office_code": "uspto",
      "link": {
        "signal": "shared_public_company",
        "tier": "shared_pco",
        "confidence": 0.95,
        "decided_by": "auto"
      }
    },
    {
      "id": "own_cipo8x8",
      "object": "owner",
      "name": "8X8, INC.",
      "canonical_name": "8X8 INC",
      "country_code": null,
      "entity_type": "corporation",
      "office_code": "cipo",
      "link": {
        "signal": "madrid_ir",
        "tier": "madrid_ir",
        "confidence": 0.95,
        "decided_by": "auto",
        "matched_irs": ["1600856"]
      }
    }
  ],
  "updated_at": "2026-06-10T00:00:00Z",
  "request_id": "req_xyz789"
}

​
Overview

Retrieve a single resolved entity by ID. A resolved entity embeds its member owners (one per office) with the per-link evidence that justified each link. Public-company facts (publicly_traded, ticker, tickers, lei, has_lei) are aggregated over the member companies and returned on the entity — the union of every member’s SEC/GLEIF links, so the entity carries a company’s ticker even when only one office record does. An ent_* id can be either a resolved entity or a derived singleton (ent_<owner-uuid> for an unlinked owner). Both resolve here. Passing a derived id for an owner that has since been linked returns the real entity — the response id may differ from the one you requested. Cached derived ids never 404.

​
Path Parameters

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

​
Response

​
id
string
Entity ID (ent_*). May differ from the requested id when a derived id resolved to its real entity.
​
object
string
Always entity.
​
name
string
Survivorship display name.
​
country_code
string | null
ISO 3166-1 alpha-2 country code.
​
entity_type
string | null
Entity type (e.g. corporation).
​
entity_id_type
string
resolved for a materialized entity, derived for a singleton.
​
publicly_traded
boolean
Whether the aggregated member companies include an active SEC company with a ticker. A derived singleton exposes the owner’s own public-company facts when present (pco-linked); otherwise false. false means no confirmed match, not confirmed-private.
​
ticker
string | null
Survivorship ticker (the first of tickers); null when none.
​
tickers
string[]
Deduped, uppercased SEC tickers across all member companies. For a derived singleton, the owner’s own tickers when pco-linked; otherwise empty.
​
lei
string | null
Survivorship GLEIF LEI (first aggregated member LEI).
​
has_lei
boolean
Whether any GLEIF LEI is present across member companies (a derived singleton: the owner’s own when pco-linked).
​
trademark_count
integer
Distinct trademarks across all members (co-owned marks counted once).
​
member_count
integer
Number of member owners.
​
parent_entity_id
string | null
GLEIF parent entity id, when present (resolved entities only).
​
members
object[]
​
updated_at
string
Last change to the entity or its membership (drives the ETag).
​
request_id
string
Unique request identifier for support.
The link evidence is a deliberately narrow projection. The model id, prompt hash, and any LLM rationale that justified a link are operational data — never returned through the API.
{
  "id": "ent_R3jK9mN2",
  "object": "entity",
  "name": "8x8, Inc.",
  "country_code": "US",
  "entity_type": "corporation",
  "entity_id_type": "resolved",
  "publicly_traded": true,
  "ticker": "EGHT",
  "tickers": ["EGHT"],
  "lei": "5493001KQHV5W2NMMW07",
  "has_lei": true,
  "trademark_count": 214,
  "member_count": 2,
  "parent_entity_id": null,
  "members": [
    {
      "id": "own_uspto8x8",
      "object": "owner",
      "name": "8x8, Inc.",
      "canonical_name": "8X8 INC",
      "country_code": "US",
      "entity_type": "corporation",
      "office_code": "uspto",
      "link": {
        "signal": "shared_public_company",
        "tier": "shared_pco",
        "confidence": 0.95,
        "decided_by": "auto"
      }
    },
    {
      "id": "own_cipo8x8",
      "object": "owner",
      "name": "8X8, INC.",
      "canonical_name": "8X8 INC",
      "country_code": null,
      "entity_type": "corporation",
      "office_code": "cipo",
      "link": {
        "signal": "madrid_ir",
        "tier": "madrid_ir",
        "confidence": 0.95,
        "decided_by": "auto",
        "matched_irs": ["1600856"]
      }
    }
  ],
  "updated_at": "2026-06-10T00:00:00Z",
  "request_id": "req_xyz789"
}

​
Code Examples

curl "https://api.signa.so/v1/entities/ent_R3jK9mN2" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400id_type_mismatchAn ID of another type was supplied
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks the trademarks:read scope
404not_foundNo such entity, or a derived id for a suppressed / merged-away owner
410entity_mergedThe entity was fused into another; follow merged_into to the successor