Skip to main content
GET
/
v1
/
entities
/
{id}
/
trademarks
Entity Trademarks
curl --request GET \
  --url https://api.signa.so/v1/entities/{id}/trademarks \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "object": "trademark",
      "mark_text": "8X8",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "filing_date": "2018-04-12",
      "owner_name": "8x8, Inc.",
      "owners": [
        {
          "id": "own_uspto8x8",
          "name": "8x8, Inc.",
          "country_code": "US",
          "entity_id": "ent_R3jK9mN2",
          "entity_id_type": "resolved"
        }
      ]
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6ImFiYyJ9" },
  "request_id": "req_fY5pQ1rS"
}

​
Overview

Returns a paginated, summary-tier list of trademarks held by all member owners of the entity — the global-portfolio view. Where Owner Trademarks is one office’s record, this fans out across every office the entity has been resolved into, so a single call returns the company’s worldwide portfolio. Every Appendix A filter from List Trademarks is available here, scoped automatically to the entity’s members. Arrays are comma-separated, date ranges use flat _gte / _gt / _lte / _lt operators, and booleans must be the literal strings true or false. When no sort and no q are supplied, results come back in the search index’s internal order; a q query ranks by relevance. A derived ent_<owner-uuid> id is accepted and degrades to that one owner’s marks.

​
Path Parameters

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

​
Query Parameters

The full List Trademarks filter set applies (status, mark classification, identifiers, geography, Nice/Vienna codes, date ranges, public-company filters, and boolean flags), plus:
​
q
string
Relevance text search within the entity’s marks.
​
sort
string
Sort field(s), comma-separated, - prefix for descending. Default -filing_date.
​
limit
integer
default:"20"
Items per page (1-100).
​
cursor
string
Pagination cursor from a previous response.

​
Response

​
data
object[]
Array of trademark summary objects across all member owners. Each row’s owners[] carries entity_id so you can confirm the grouping.
​
has_more
boolean
Whether more marks are available.
​
pagination
object
Cursor for the next page.
{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "object": "trademark",
      "mark_text": "8X8",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "filing_date": "2018-04-12",
      "owner_name": "8x8, Inc.",
      "owners": [
        {
          "id": "own_uspto8x8",
          "name": "8x8, Inc.",
          "country_code": "US",
          "entity_id": "ent_R3jK9mN2",
          "entity_id_type": "resolved"
        }
      ]
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6ImFiYyJ9" },
  "request_id": "req_fY5pQ1rS"
}

​
Code Examples

curl "https://api.signa.so/v1/entities/ent_R3jK9mN2/trademarks?status_primary=active&limit=20" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorInvalid query parameters or date range
401unauthorizedMissing or invalid API key
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
422entity_too_largeThe entity resolves to more than 10,000 member owners. error.reason is member_owners_too_large (carries member_count / member_count_limit). The sibling family_graph_too_large reason — graph fields related_entity_limit / depth_limit — is fired only by ?entity_group= family walks on List Trademarks, not by this per-entity endpoint.
429rate_limitedToo many requests