Owner Trademarks

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

{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "object": "trademark",
      "mark_text": "AURORA",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "filing_date": "2023-04-12",
      "registration_date": "2024-09-18",
      "classifications": [
        { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
        { "nice_class": 35, "goods_services_text": "Online retail store services featuring digital media" },
        { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
      ],
      "owner_name": "Aurora Digital Inc."
    },
    {
      "id": "tm_Qr6nK9jL",
      "object": "trademark",
      "mark_text": "AURORA DIGITAL",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "euipo",
      "jurisdiction_code": "EU",
      "filing_date": "2023-07-20",
      "registration_date": "2024-11-05",
      "classifications": [
        { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
        { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
      ],
      "owner_name": "Aurora Digital Inc."
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6ImFiYyJ9"
  },
  "request_id": "req_fY5pQ1rS"
}

GET

owners

{id}

trademarks

Owner Trademarks

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

{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "object": "trademark",
      "mark_text": "AURORA",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "filing_date": "2023-04-12",
      "registration_date": "2024-09-18",
      "classifications": [
        { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
        { "nice_class": 35, "goods_services_text": "Online retail store services featuring digital media" },
        { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
      ],
      "owner_name": "Aurora Digital Inc."
    },
    {
      "id": "tm_Qr6nK9jL",
      "object": "trademark",
      "mark_text": "AURORA DIGITAL",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "euipo",
      "jurisdiction_code": "EU",
      "filing_date": "2023-07-20",
      "registration_date": "2024-11-05",
      "classifications": [
        { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
        { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
      ],
      "owner_name": "Aurora Digital Inc."
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6ImFiYyJ9"
  },
  "request_id": "req_fY5pQ1rS"
}

Overview

Returns a paginated list of trademarks held by the specified owner. Use this for portfolio views, competitor intelligence, or auditing an entity’s IP holdings across jurisdictions. When no sort parameter is supplied and no q text query is given, results are returned in the search index’s internal document order (not sorted by any specific field). When a q text query is provided, results are ranked by relevance score with filing date as a tiebreaker. You can pass an explicit sort parameter to control ordering (e.g. sort=-filing_date). Every Appendix A filter from the main List Trademarks endpoint is available here, scoped automatically to the parent owner. Arrays are comma-separated, date ranges use flat _gte / _lt operators, and booleans must be the literal strings true or false.

Path Parameters

string

required

Owner ID (e.g., own_Rj3kL9mN).

Query Parameters

Pagination

limit

integer

default:"20"

Items per page (1-100).

cursor

string

Pagination cursor from a previous response.

Status filters

status_primary

string | string[]

Primary status: active, pending, inactive, unknown. Accepts a single value or a comma-separated list — e.g. ?status_primary=active,pending matches TESS-style “live” marks.

status_stage

string

Status stage(s), comma-separated.

status_reason

string

Status reason(s), comma-separated.

challenge_states

string

Challenge state(s), comma-separated.

Mark classification

mark_feature_type

string

Mark feature type(s), comma-separated.

mark_legal_category

string

Legal category(ies), comma-separated.

right_kind

string

Right kind.

filing_route

string

Filing route(s), comma-separated.

scope_kind

string

Scope kind(s), comma-separated.

Identifiers

application_number

string

Application number. Requires office.

registration_number

string

Registration number. Requires office.

ir_number

string

Madrid international registration number.

office

string

Office code (required with application_number or registration_number).

Geography

jurisdictions

string

Jurisdiction codes, comma-separated (e.g. ?jurisdictions=US,EU).

offices

string

Office codes, comma-separated (e.g. ?offices=uspto,euipo).

owner_country

string

Owner country code (ISO 3166-1 alpha-2).

Classification codes

nice_classes

string

Nice classes 1-45, comma-separated (e.g. ?nice_classes=9,42).

vienna_codes

string

Vienna figurative codes, comma-separated.

Date ranges

Each operator accepts YYYY-MM-DD; updated_at_* accepts ISO 8601 timestamps. _gte must be strictly before _lt.

filing_date_gte

string

Filing date >=.

filing_date_lt

string

Filing date <.

registration_date_gte

string

Registration date >=.

registration_date_lt

string

Registration date <.

expiry_date_gte

string

Expiry date >=.

expiry_date_lt

string

Expiry date <.

renewal_due_date_gte

string

Renewal due date >=.

renewal_due_date_lt

string

Renewal due date <.

publication_date_gte

string

Publication date >=.

publication_date_lt

string

Publication date <.

termination_date_gte

string

Termination date >=.

termination_date_lt

string

Termination date <.

updated_at_gte

string

Updated at >= (ISO 8601).

updated_at_lt

string

Updated at < (ISO 8601).

Entity filters

owner_name

string

Fuzzy owner name match (within the owner’s record group).

attorney_id

string

Attorney ID (att_...).

firm_id

string

Firm ID (firm_...).

Boolean flags

has_media

boolean

Marks with media.

has_proceedings

boolean

Marks with proceedings.

is_madrid

boolean

Madrid-routed marks only.

is_retracted

boolean

Retracted marks only.

is_series_mark

boolean

Series marks only.

Response

data

object[]

Array of trademark summary objects belonging to this owner.

{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "object": "trademark",
      "mark_text": "AURORA",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "filing_date": "2023-04-12",
      "registration_date": "2024-09-18",
      "classifications": [
        { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
        { "nice_class": 35, "goods_services_text": "Online retail store services featuring digital media" },
        { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
      ],
      "owner_name": "Aurora Digital Inc."
    },
    {
      "id": "tm_Qr6nK9jL",
      "object": "trademark",
      "mark_text": "AURORA DIGITAL",
      "status": { "primary": "active", "stage": "registered" },
      "office_code": "euipo",
      "jurisdiction_code": "EU",
      "filing_date": "2023-07-20",
      "registration_date": "2024-11-05",
      "classifications": [
        { "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
        { "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
      ],
      "owner_name": "Aurora Digital Inc."
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6ImFiYyJ9"
  },
  "request_id": "req_fY5pQ1rS"
}

Code Examples

curl "https://api.signa.so/v1/owners/own_Rj3kL9mN/trademarks?status_stage=registered&offices=uspto,euipo&nice_classes=9,42&limit=20" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx"

Errors

Status	Type	Description
400	`validation_error`	Invalid query parameters or date range
401	`unauthorized`	Missing or invalid API key
404	`not_found`	Owner ID does not exist
429	`rate_limited`	Too many requests

Get Owner: owner profile and stats
Owner Related: related entities (subsidiaries, parent companies)
List Trademarks: search across all owners

Get Owner Owner Related Entities

​Overview

​Path Parameters

​Query Parameters

​Pagination

​Status filters

​Mark classification

​Identifiers

​Geography

​Classification codes

​Date ranges

​Entity filters

​Boolean flags

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Path Parameters

Query Parameters

Pagination

Status filters

Mark classification

Identifiers

Geography

Classification codes

Date ranges

Entity filters

Boolean flags

Response

Code Examples

Errors

Related Endpoints