Skip to main content
GET
/
v1
/
trademarks
/
{id}
/
related
Related Trademarks
curl --request GET \
  --url https://api.signa.so/v1/trademarks/{id}/related \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "related_trademark_id": "tm_Qr6nK9jL",
      "relationship_type": "madrid_designation_of",
      "effective_date": "2023-09-12",
      "mark_text": "AURORA",
      "office_code": "wipo",
      "status_stage": "registered",
      "direction": "outgoing",
      "target_office_code": null,
      "target_record_id": null,
      "metadata": null
    },
    {
      "related_trademark_id": null,
      "relationship_type": "seniority_claim",
      "effective_date": "2022-04-08",
      "mark_text": null,
      "office_code": null,
      "status_stage": null,
      "direction": "outgoing",
      "target_office_code": "dpma",
      "target_record_id": "30412345",
      "metadata": { "seniority_country": "DE" }
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_dW3mN9pQ"
}

Documentation Index

Fetch the complete documentation index at: https://docs.signa.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Returns mark-to-mark relationships recorded for a trademark, such as Madrid designations of a basic mark, divisionals, seniority claims, partial assignments, and Article 4bis replacements. Relationships are sourced from the office gazette and the trademark_relationship table. Use this endpoint to walk a Madrid family from the basic mark to its designations, find the divisional parent of a child application, or trace ownership lineage across mergers and partial transfers. Results are paginated and sorted by effective_date.

​
Path Parameters

​
id
string
required
Trademark ID prefixed with tm_ (e.g. tm_8kLm2nPq).

​
Query Parameters

​
relationship_type
string
Filter by a single relationship type. Omit to return every relationship for the mark. Valid values:
  • madrid_designation_of: this mark is a national designation of a Madrid IR basic mark
  • based_on_basic_application: Madrid IR built on a pending application
  • based_on_basic_registration: Madrid IR built on a registered mark
  • seniority_claim: EU mark claiming seniority from an earlier national right
  • divisional_parent: original application that this mark was divided from
  • partial_assignment_from: created by a partial assignment of an earlier mark
  • merged_into: superseded by a merger into another mark
  • transformed_from: Madrid transformation from a ceased IR
  • replaces_under_4bis: replaces an earlier national mark under Madrid Article 4bis
  • partial_transfer_of: partial transfer source mark
  • continuation_of: continuation of an earlier mark across re-filings
​
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[]
​
has_more
boolean
Whether more relationships are available.
​
pagination
object
Cursor for the next page.
​
request_id
string
Unique request identifier for support and debugging.
{
  "object": "list",
  "data": [
    {
      "related_trademark_id": "tm_Qr6nK9jL",
      "relationship_type": "madrid_designation_of",
      "effective_date": "2023-09-12",
      "mark_text": "AURORA",
      "office_code": "wipo",
      "status_stage": "registered",
      "direction": "outgoing",
      "target_office_code": null,
      "target_record_id": null,
      "metadata": null
    },
    {
      "related_trademark_id": null,
      "relationship_type": "seniority_claim",
      "effective_date": "2022-04-08",
      "mark_text": null,
      "office_code": null,
      "status_stage": null,
      "direction": "outgoing",
      "target_office_code": "dpma",
      "target_record_id": "30412345",
      "metadata": { "seniority_country": "DE" }
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_dW3mN9pQ"
}

​
Code Examples

curl -G "https://api.signa.so/v1/trademarks/tm_8kLm2nPq/related" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE" \
  --data-urlencode "relationship_type=madrid_designation_of" \
  --data-urlencode "limit=10"

​
Errors

StatusTypeDescription
400validation_errorInvalid id format or unsupported query parameter value
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks the trademarks:read scope
404not_foundTrademark ID does not exist
429rate_limitedRate limit exceeded