List Owners

List trademark owners with filtering, public-company joins, and cursor pagination

GET /v1/owners

List Owners

cURL

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

Response

{
  "object": "list",
  "data": [
    {
      "id": "own_R3jK9mN2",
      "object": "owner",
      "name": "Apple Inc.",
      "canonical_name": "APPLE INC",
      "country_code": "US",
      "entity_type": "corporation",
      "trademark_count": 1847,
      "entity_id": "ent_R3jK9mN2",
      "entity_id_type": "resolved"
    },
    {
      "id": "own_Yk8mN2pQ",
      "object": "owner",
      "name": "Alphabet Inc.",
      "canonical_name": "ALPHABET INC",
      "country_code": "US",
      "entity_type": "corporation",
      "trademark_count": 1521,
      "entity_id": "ent_Yk8mN2pQ",
      "entity_id_type": "derived"
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6Im93bl9SM2pLOW1OMiIsInNvcnQiOjE4NDd9"
  },
  "request_id": "req_xyz789"
}

Overview

Returns a paginated, summary-tier list of trademark owners. Supports fuzzy name search, country and entity-type filters, plus virtual filters that join public-company enrichment to find owners with SEC ticker or GLEIF LEI matches. Suppressed owners (placeholder records, frozen entities) are always excluded.

Query Parameters

q · string

Fuzzy name search via trigram similarity. Tolerant of typos and word reordering.

country_code · string

Filter by ISO 3166-1 alpha-2 country code (e.g. US, GB).

entity_type · string

Filter by entity type (e.g. corporation, individual, partnership).

ticker · string

Virtual filter: matches owners linked to a public company with the given stock ticker (e.g. AAPL).

lei · string

Virtual filter: matches owners linked to a GLEIF Legal Entity Identifier.

publicly_traded · boolean

Virtual filter: true returns owners matched to an active SEC company with a ticker. false means no confirmed active ticker match, not confirmed private. Strict true/false only.

has_lei · boolean

Virtual filter: true returns owners matched to a GLEIF legal entity. false means no confirmed LEI match. Strict true/false only.

sort · string

Sort field with optional - prefix for descending. One of -trademark_count, trademark_count, -registration_rate, registration_rate, -latest_filing, latest_filing, -name, name. Default: -trademark_count.

include_total · boolean · default: "false"

When true, includes an accurate total count in pagination.total_count.

limit · integer · default: "20"

Page size, between 1 and 100.

cursor · string

Opaque cursor returned in the previous response’s pagination.cursor.

Response

object · string

Always list.

data · object[]

Show Owner summary object

id · string

Owner ID prefixed with own_.

object · string

Always owner.

name · string

Display name of the owner.

canonical_name · string

Normalized name used for entity resolution and deduplication.

country_code · string | null

ISO 3166-1 alpha-2 country code.

entity_type · string | null

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

trademark_count · integer

Total trademarks owned.

entity_id · string

The resolved-entity id this owner belongs to (ent_*), or the derived ent_<owner-uuid> singleton. See Entities.

entity_id_type · string

resolved or derived. On the list this is derived until the owner-index refresh propagates the resolved link; Get Owner detail always carries the resolved value.

has_more · boolean

Whether more owners are available.

pagination · object

Cursor for the next page.

request_id · string

Unique request identifier for support and debugging.

Response

{
  "object": "list",
  "data": [
    {
      "id": "own_R3jK9mN2",
      "object": "owner",
      "name": "Apple Inc.",
      "canonical_name": "APPLE INC",
      "country_code": "US",
      "entity_type": "corporation",
      "trademark_count": 1847,
      "entity_id": "ent_R3jK9mN2",
      "entity_id_type": "resolved"
    },
    {
      "id": "own_Yk8mN2pQ",
      "object": "owner",
      "name": "Alphabet Inc.",
      "canonical_name": "ALPHABET INC",
      "country_code": "US",
      "entity_type": "corporation",
      "trademark_count": 1521,
      "entity_id": "ent_Yk8mN2pQ",
      "entity_id_type": "derived"
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6Im93bl9SM2pLOW1OMiIsInNvcnQiOjE4NDd9"
  },
  "request_id": "req_xyz789"
}

Code Examples

cURL

curl -G "https://api.signa.so/v1/owners" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE" \
  --data-urlencode "country_code=US" \
  --data-urlencode "publicly_traded=true" \
  --data-urlencode "sort=-trademark_count" \
  --data-urlencode "limit=20"

Errors

Status	Type	Description
400	validation_error	Invalid sort, unknown filter value, or non-strict boolean for publicly_traded or has_lei
401	unauthorized	Missing or invalid API key
403	forbidden	API key lacks the trademarks:read scope
429	rate_limited	Rate limit exceeded

Related Endpoints

• Get Owner — full owner detail
• Owner Trademarks — portfolio of marks owned
• Owner Related — corporate parent and subsidiary relationships