Skip to main content
GET
/
v1
/
trademarks
/
suggest
Suggest Trademarks
curl --request GET \
  --url https://api.example.com/v1/trademarks/suggest
{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "status_stage": "registered",
      "nice_classes": [9, 35, 42],
      "owner_name": "Aurora Digital Inc."
    },
    {
      "id": "tm_Qr6nK9jL",
      "mark_text": "AURORA DIGITAL",
      "office_code": "euipo",
      "jurisdiction_code": "EU",
      "status_stage": "registered",
      "nice_classes": [9, 42],
      "owner_name": "Aurora Digital Inc."
    },
    {
      "id": "tm_Vt3pM7nR",
      "mark_text": "AURORA BOREALIS",
      "office_code": "cipo",
      "jurisdiction_code": "CA",
      "status_stage": "filed",
      "nice_classes": [25, 35],
      "owner_name": "Aurora Fashion Corp."
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_eX4nP0qR"
}

​
Overview

Returns trademark name suggestions based on a prefix query. Designed for typeahead/autocomplete interfaces where low latency matters. Results are ranked by a combination of text relevance and trademark activity (active marks rank higher). This endpoint uses edge-ngram indexing for fast prefix matching and returns a lightweight response optimized for dropdown rendering.

​
Query Parameters

​
q
string
required
Prefix query (minimum 2 characters)
​
limit
integer
default:"10"
Maximum suggestions to return (max 25)
​
office_code
string
Filter suggestions to a specific office (e.g., uspto, euipo)
​
status_stage
string
Filter by status stage (e.g., registered, filed)

​
Response

​
data
object[]
{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "status_stage": "registered",
      "nice_classes": [9, 35, 42],
      "owner_name": "Aurora Digital Inc."
    },
    {
      "id": "tm_Qr6nK9jL",
      "mark_text": "AURORA DIGITAL",
      "office_code": "euipo",
      "jurisdiction_code": "EU",
      "status_stage": "registered",
      "nice_classes": [9, 42],
      "owner_name": "Aurora Digital Inc."
    },
    {
      "id": "tm_Vt3pM7nR",
      "mark_text": "AURORA BOREALIS",
      "office_code": "cipo",
      "jurisdiction_code": "CA",
      "status_stage": "filed",
      "nice_classes": [25, 35],
      "owner_name": "Aurora Fashion Corp."
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_eX4nP0qR"
}

​
Code Examples

curl "https://api.signa.so/v1/trademarks/suggest?q=aur&limit=5" \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorQuery q is missing or shorter than 2 characters
401unauthorizedMissing or invalid API key
429rate_limitedToo many requests