Skip to main content
GET
/
v1
/
trademarks
/
suggest
Suggest Trademarks
curl --request GET \
  --url https://api.signa.so/v1/trademarks/suggest \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "object": "trademark_suggestion",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "status_stage": "registered"
    },
    {
      "id": "tm_Qr6nK9jL",
      "object": "trademark_suggestion",
      "mark_text": "AURORA DIGITAL",
      "office_code": "euipo",
      "status_stage": "registered"
    },
    {
      "id": "tm_Vt3pM7nR",
      "object": "trademark_suggestion",
      "mark_text": "AURORA BOREALIS",
      "office_code": "cipo",
      "status_stage": "filed"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_eX4nP0qR"
}

​
Overview

Returns trademark name suggestions for a prefix query. Designed for typeahead interfaces where low latency matters: suggestions come from the compact tier of the search index, with edge n-gram matching on mark_text. Results are returned as a non-paginated list (top N). This endpoint requires the trademarks:read scope.

​
Query Parameters

​
q
string
required
Prefix query, between 2 and 200 characters.
​
limit
integer
default:"10"
Maximum number of suggestions to return, between 1 and 50.
​
jurisdictions
string
Filter by jurisdiction codes, comma-separated (e.g. ?jurisdictions=US,EU).
​
nice_classes
string
Filter by Nice classification numbers, 1 to 45, comma-separated (e.g. ?nice_classes=9,42).
​
status_stage
string
Filter by status stage, comma-separated (e.g. ?status_stage=registered,published).

​
Response

​
object
string
Always list.
​
data
object[]
​
has_more
boolean
Always false. Suggest is not paginated.
​
pagination
object
Always { "cursor": null }.
​
request_id
string
Unique request identifier for support and debugging.
{
  "object": "list",
  "data": [
    {
      "id": "tm_8kLm2nPq",
      "object": "trademark_suggestion",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "status_stage": "registered"
    },
    {
      "id": "tm_Qr6nK9jL",
      "object": "trademark_suggestion",
      "mark_text": "AURORA DIGITAL",
      "office_code": "euipo",
      "status_stage": "registered"
    },
    {
      "id": "tm_Vt3pM7nR",
      "object": "trademark_suggestion",
      "mark_text": "AURORA BOREALIS",
      "office_code": "cipo",
      "status_stage": "filed"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "request_id": "req_eX4nP0qR"
}

​
Code Examples

curl -G "https://api.signa.so/v1/trademarks/suggest" \
  -H "Authorization: Bearer sig_YOUR_KEY_HERE" \
  --data-urlencode "q=aur" \
  --data-urlencode "jurisdictions=US,EU" \
  --data-urlencode "nice_classes=9,42" \
  --data-urlencode "limit=10"

​
Errors

StatusTypeDescription
400validation_errorq shorter than 2 characters, limit outside 1-50, or invalid filter values
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks the trademarks:read scope
429rate_limitedRate limit exceeded
  • List Trademarks — multi-strategy text and phonetic search with aggregations and sort