curl --request GET \
--url https://api.signa.so/v1/search \
--header 'Authorization: Bearer <token>'{
"results": [
{
"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>"
}
}
],
"pagination": {
"total_results": 123,
"has_more": true,
"next_cursor": "<string>"
},
"search_metadata": {
"query": "<string>",
"search_type": "<string>",
"query_time_ms": 123,
"offices_searched": [
"<string>"
],
"credits_used": 123
}
}Main search endpoint supporting exact, fuzzy, and phonetic matching.
Search Types:
exact - Direct, case-insensitive text matching (default, fastest)fuzzy - Typo-tolerant matching using Levenshtein distancephonetic - Sound-alike matching using Metaphone algorithmUse Cases:
curl --request GET \
--url https://api.signa.so/v1/search \
--header 'Authorization: Bearer <token>'{
"results": [
{
"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>"
}
}
],
"pagination": {
"total_results": 123,
"has_more": true,
"next_cursor": "<string>"
},
"search_metadata": {
"query": "<string>",
"search_type": "<string>",
"query_time_ms": 123,
"offices_searched": [
"<string>"
],
"credits_used": 123
}
}Use your API key from the dashboard. Include it in the Authorization header:
Authorization: Bearer YOUR_API_KEYGet your API key at https://signa.so/dashboard
Search query
2Type of search to perform
exact, fuzzy, phonetic Office code or comma-separated list (e.g., "USPTO" or "USPTO,EUIPO"). Default searches all offices.
Filter by Nice Classification classes (comma-separated)
1 <= x <= 45Filter by unified status codes
live_pending, live_registered, live_opposition, dead_abandoned, dead_cancelled, dead_expired Filter by owner name
Filter by mark type
word, logo, combined Similarity threshold for fuzzy search (0-1, higher = stricter)
0 <= x <= 1Maximum results per page
1 <= x <= 100Pagination cursor from previous response
Additional data to include
images, history, related