Skip to main content
GET
/
v1
/
trademarks
/
{trademark_id}
Get trademark by ID
curl --request GET \
  --url https://api.signa.so/v1/trademarks/{trademark_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "tm_us_1234567",
  "office": {
    "code": "USPTO",
    "name": "United States Patent and Trademark Office",
    "country": "US",
    "region": "North America"
  },
  "mark": {
    "text": "APPLE",
    "transliteration": "<string>",
    "translation": "<string>",
    "type": "word",
    "disclaimer": "<string>"
  },
  "status": {
    "unified_status": "live_registered",
    "unified_status_code": "LR",
    "status_date": "2024-01-15",
    "office_status": "Registered",
    "office_status_code": "<string>",
    "substatus": "<string>",
    "reason": "<string>"
  },
  "canonical_id": "tm_canonical_apple_001",
  "office_data": {
    "registration_number": "1234567",
    "serial_number": "87654321",
    "application_number": "<string>",
    "publication_number": "<string>",
    "filing_reference": "<string>"
  },
  "classifications": {
    "nice_classes": [
      9,
      35,
      42
    ],
    "goods_services": "Computers; Retail services; Software design",
    "office_classes": [
      "<string>"
    ]
  },
  "owners": [
    {
      "name": "Apple Inc.",
      "type": "corporation",
      "country": "US",
      "address": {
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "country": "<string>"
      },
      "role": "owner",
      "effective_date": "2023-12-25"
    }
  ],
  "dates": {
    "filing_date": "2020-03-15",
    "priority_date": "2023-12-25",
    "publication_date": "2023-12-25",
    "registration_date": "2023-12-25",
    "expiry_date": "2023-12-25",
    "renewal_date": "2023-12-25"
  },
  "coverage": {
    "countries": [
      "US"
    ],
    "territories": [
      "<string>"
    ],
    "madrid_protocol": true
  },
  "images": {
    "thumbnail": "<string>",
    "full": "<string>",
    "formats": [
      "<string>"
    ]
  },
  "related_registrations": {
    "count": 123,
    "canonical_id": "<string>",
    "same_mark_other_offices": [
      {
        "id": "<string>",
        "office": "<string>",
        "registration_number": "<string>",
        "status": "<string>",
        "filing_date": "2023-12-25",
        "url": "<string>"
      }
    ]
  },
  "metadata": {
    "data_quality_score": 50,
    "data_completeness": 50,
    "last_verified": "2023-11-07T05:31:56Z",
    "normalization_version": "<string>"
  },
  "similarity_score": 0.5,
  "urls": {
    "api": "<string>",
    "web": "<string>",
    "office_url": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Use your API key from the dashboard. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key at https://signa.so/dashboard

Path Parameters

trademark_id
string
required

Trademark ID

Query Parameters

include
enum<string>[]

Additional data to include

Available options:
history,
related,
similar,
documents

Response

Trademark details

Unified trademark object - normalized from official sources. All trademarks, regardless of office, use this schema.

id
string
required

Unique trademark identifier

Example:

"tm_us_1234567"

office
object
required
mark
object
required
status
object
required
canonical_id
string

Cross-office family ID

Example:

"tm_canonical_apple_001"

office_data
object
classifications
object
owners
object[]
dates
object
coverage
object
images
object
metadata
object
similarity_score
number<float>

Similarity score (only in search results)

Required range: 0 <= x <= 1
urls
object