Get Owner

Retrieve an owner profile by ID

GET /v1/owners/{id}

Get Owner

cURL

curl --request GET \
  --url https://api.signa.so/v1/owners/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "own_abc123",
  "object": "owner",
  "name": "Apple Inc.",
  "canonical_name": "APPLE INC",
  "name_original_script": null,
  "country_code": "US",
  "entity_type": "corporation",
  "address": {
    "street": "One Apple Park Way",
    "city": "Cupertino",
    "state": "CA",
    "country_code": "US",
    "postal_code": "95014"
  },
  "entity_id": "ent_R3jK9mN2",
  "entity_id_type": "resolved",
  "publicly_traded": true,
  "ticker": "AAPL",
  "lei": "HWUPKR0MPOU8FGXBT394",
  "has_lei": true,
  "companies_source": "entity",
  "aliases": [
    {
      "name": "Apple Computer Inc.",
      "type": "former_name",
      "source_office": "uspto"
    },
    {
      "name": "Apple Computer, Inc.",
      "type": "former_name",
      "source_office": "uspto"
    }
  ],
  "identifiers": [
    {
      "type": "sec_cik",
      "value": "320193"
    }
  ],
  "companies": [
    {
      "source": "sec",
      "source_id": "0000320193",
      "legal_name": "Apple Inc.",
      "ticker": "AAPL",
      "exchange": "NASDAQ",
      "lei": null,
      "entity_status": "active"
    },
    {
      "source": "gleif",
      "source_id": "HWUPKR0MPOU8FGXBT394",
      "legal_name": "APPLE INC.",
      "ticker": null,
      "exchange": null,
      "lei": "HWUPKR0MPOU8FGXBT394",
      "entity_status": "active"
    }
  ],
  "stats": {
    "trademark_count": 1847,
    "registered_count": 1203,
    "pending_count": 87,
    "expired_count": 312,
    "cancelled_count": 45,
    "abandoned_count": 200,
    "registration_rate": 0.651,
    "abandonment_rate": 0.108,
    "jurisdiction_count": 5,
    "earliest_filing": "1985-04-01",
    "latest_filing": "2026-03-15",
    "computed_at": "2026-03-24T00:00:00Z"
  },
  "request_id": "req_xyz789"
}

Path Parameters

id · string · required

Owner ID (e.g., own_abc123)

Response

id · string

Owner ID (own_*)

object · string

Always "owner"

name · string

Display name of the owner

canonical_name · string

Normalized name used for entity resolution and deduplication

name_original_script · string

Owner name in original script (may be null)

country_code · string

ISO country code

entity_type · string

Entity type (e.g., corporation, individual)

address · object

Owner address (may be null)

entity_id · string

The resolved-entity id this owner belongs to (ent_*). When the owner is linked to a materialized entity, this is that entity’s id; otherwise it is the derived ent_<owner-uuid> singleton. Always present, so you can group owners by entity_id unconditionally. See Entities.

entity_id_type · string

resolved when linked to a materialized entity, derived for a lazy singleton.

publicly_traded · boolean

Whether the (possibly entity-inherited) company set includes an active SEC company with a ticker. A false value means no confirmed match, not confirmed-private.

ticker · string | null

First SEC ticker across the (possibly inherited) company set.

lei · string | null

First GLEIF LEI across the (possibly inherited) company set.

has_lei · boolean

Whether any GLEIF LEI is present across the (possibly inherited) company set.

companies_source · string

entity when the company facts are inherited across entity members (served through the entity), or direct when the owner is an unlinked singleton reporting only its own links.

aliases · object[]

Show Alias object

name · string

Alias name

type · string

Alias type

source_office · string

Office that reported this alias

identifiers · object[]

External identifiers (SEC CIK, LEI, etc.)

companies · object[]

Omitted when the owner has no matched company records. When the owner is linked to an entity, this is the union of all members’ company links (served through the entity) — the owner’s own links are included.

Show Public company match

source · string

Data source (e.g., sec, gleif)

source_id · string

Source-specific identifier

legal_name · string

Company legal name from the source record

ticker · string | null

Stock ticker symbol for SEC matches

exchange · string | null

Stock exchange for SEC matches

lei · string | null

Legal Entity Identifier for GLEIF matches

entity_status · string

active, inactive, or delisted

confidence · number

Match confidence, when available

verified_at · string | null

When the match was verified, when available

verified_by · string | null

Verifier identifier, when available

stats · object

Show Portfolio statistics

trademark_count · integer

Total trademarks owned

registered_count · integer

Currently registered trademarks

pending_count · integer

Trademarks with pending status

expired_count · integer

Expired trademarks

cancelled_count · integer

Cancelled trademarks

abandoned_count · integer

Abandoned trademarks

registration_rate · number

Ratio of registered to total trademarks

abandonment_rate · number

Ratio of abandoned to total trademarks

jurisdiction_count · integer

Number of distinct jurisdictions

earliest_filing · string

Earliest filing date (ISO 8601)

latest_filing · string

Most recent filing date (ISO 8601)

computed_at · string

When stats were last computed (ISO 8601)

The ranked-list fields top_classes, top_attorneys, top_mark_types, jurisdictions, and yearly_trend were removed from the owner stats response in April 2026.

Public-company facts are served through the entity. When an owner is a member of a resolved entity, publicly_traded, ticker, lei, has_lei, and companies[] reflect the entity’s aggregated facts — the union of every member’s SEC/GLEIF links. So a non-US office record that itself carries no ticker still surfaces the company’s ticker and LEI when a sibling member is matched. companies_source is entity in that case and direct for an unlinked singleton. (Improved coverage versus pre-entity behavior — flag this if you previously deduplicated on your side.)

{
  "id": "own_abc123",
  "object": "owner",
  "name": "Apple Inc.",
  "canonical_name": "APPLE INC",
  "name_original_script": null,
  "country_code": "US",
  "entity_type": "corporation",
  "address": {
    "street": "One Apple Park Way",
    "city": "Cupertino",
    "state": "CA",
    "country_code": "US",
    "postal_code": "95014"
  },
  "entity_id": "ent_R3jK9mN2",
  "entity_id_type": "resolved",
  "publicly_traded": true,
  "ticker": "AAPL",
  "lei": "HWUPKR0MPOU8FGXBT394",
  "has_lei": true,
  "companies_source": "entity",
  "aliases": [
    {
      "name": "Apple Computer Inc.",
      "type": "former_name",
      "source_office": "uspto"
    },
    {
      "name": "Apple Computer, Inc.",
      "type": "former_name",
      "source_office": "uspto"
    }
  ],
  "identifiers": [
    {
      "type": "sec_cik",
      "value": "320193"
    }
  ],
  "companies": [
    {
      "source": "sec",
      "source_id": "0000320193",
      "legal_name": "Apple Inc.",
      "ticker": "AAPL",
      "exchange": "NASDAQ",
      "lei": null,
      "entity_status": "active"
    },
    {
      "source": "gleif",
      "source_id": "HWUPKR0MPOU8FGXBT394",
      "legal_name": "APPLE INC.",
      "ticker": null,
      "exchange": null,
      "lei": "HWUPKR0MPOU8FGXBT394",
      "entity_status": "active"
    }
  ],
  "stats": {
    "trademark_count": 1847,
    "registered_count": 1203,
    "pending_count": 87,
    "expired_count": 312,
    "cancelled_count": 45,
    "abandoned_count": 200,
    "registration_rate": 0.651,
    "abandonment_rate": 0.108,
    "jurisdiction_count": 5,
    "earliest_filing": "1985-04-01",
    "latest_filing": "2026-03-15",
    "computed_at": "2026-03-24T00:00:00Z"
  },
  "request_id": "req_xyz789"
}