Trademarks
Parties
Monitoring
Reference
Administration
Operational
Get Trademark
curl --request GET \
--url https://api.signa.so/v1/trademarks/{id} \
--header 'Authorization: Bearer <token>'{
"id": "tm_019d14a7-efb6-754c-9a96-14f64baadc44",
"object": "trademark",
"mark_text": "COCA-COLA",
"mark_text_language": null,
"mark_text_script": null,
"mark_feature_type": "figurative",
"mark_legal_category": "standard",
"right_kind": "trademark",
"is_series_mark": null,
"series_count": null,
"status": {
"primary": "active",
"stage": "registered",
"reason": null,
"challenges": [],
"effective_date": "2022-09-27",
"source": "explicit",
"raw_code": "800",
"raw_label": null
},
"office_code": "uspto",
"jurisdiction_code": "US",
"filing_route": "direct_national",
"scope_kind": "national",
"origin_office_code": null,
"source_primary_id": "70022406",
"application_number": "70022406",
"registration_number": "0022406",
"ir_number": null,
"filing_date": "1892-05-14",
"registration_date": "1893-01-31",
"expiry_date": "2033-01-31",
"expiry_date_basis": "derived",
"renewal_due_date": "2033-01-31",
"publication_date": null,
"priority_date": null,
"termination_date": null,
"protection_effective_date": null,
"designation_date": null,
"dependency_period_end_date": null,
"transformation_deadline_date": null,
"is_retracted": false,
"owners": [
{
"id": "own_019d25f4-431a-72dc-a654-1c1acab5a3c4",
"name": "Coca Cola Company, The",
"country_code": null,
"entity_type": "corporation",
"role": "owner",
"address": {
"lines": ["One Coca-Cola Plaza"],
"city": "ATLANTA",
"state": "GA",
"postal_code": "30313",
"country_code": "US"
}
}
],
"attorneys": [
{
"id": "att_019d14a7-efe2-7015-a30c-11ac541fe714",
"name": "Katelyn Andrews",
"firm_id": "firm_ba9d8016-635a-4ca7-953c-ceab7e482e30",
"firm_name": "THE COCA-COLA COMPANY",
"role": "correspondent",
"address": {
"lines": ["One Coca-Cola Plaza"],
"city": "ATLANTA",
"state": "GA",
"postal_code": "30313",
"country_code": "US"
}
}
],
"classifications": [
{
"nice_class": 32,
"nice_edition": null,
"goods_services_text": null,
"goods_services_language": null,
"status": "accepted",
"class_status_raw": "6"
}
],
"design_codes": [],
"text_variants": [],
"statements": [
{
"type": "description",
"text": "The said trade-mark of said company consists of the word or words \"Coca Cola\".",
"language_code": null,
"applies_to_class": null
}
],
"media": [
{
"id": "med_c15633e7-ed08-45d2-8ea0-0de332cae378",
"media_type": "image",
"mime_type": "image/png",
"url": "https://api.signa.so/v1/trademarks/tm_019d14a7-efb6-754c-9a96-14f64baadc44/media/med_c15633e7-ed08-45d2-8ea0-0de332cae378",
"is_primary": true
}
],
"priority_claims": [],
"filing_bases": [
{
"basis_type": "use_in_commerce",
"nice_class_number": 32,
"first_use_date": "1887-06-28",
"first_use_in_commerce_date": "1887-06-28",
"foreign_application_number": null,
"foreign_country_code": null
}
],
"publications": [],
"office_extensions": {
"register_type": "principal"
},
"deadlines": [
{
"type": "combined_renewal_and_use",
"name": "Section 8+9 — Renewal + Declaration of Use",
"due_date": "2033-01-31",
"grace_expiry": "2033-07-31",
"window_opens": "2032-01-31",
"jurisdiction_code": "US",
"status": "future",
"urgency": "routine",
"days_until_due": 2484,
"consequence_if_missed": "cancellation_and_expiration"
}
],
"madrid": null,
"has_media": true,
"events_count": 21,
"proceedings_count": 0,
"coverage_count": 0,
"relationships_count": 0,
"data_freshness": {
"source_data_date": "2022-10-28",
"source_format": "dtd_v2",
"last_updated_at": "2026-03-30T02:13:13.704Z"
},
"created_at": "2026-03-22T08:27:23.446Z",
"updated_at": "2026-03-30T02:13:13.704Z",
"request_id": "req_01kp4v2yycy3pq3czhxcsmn9md"
}
Retrieve
Get Trademark
Retrieve a single trademark by ID
GET
/
v1
/
trademarks
/
{id}
Get Trademark
curl --request GET \
--url https://api.signa.so/v1/trademarks/{id} \
--header 'Authorization: Bearer <token>'{
"id": "tm_019d14a7-efb6-754c-9a96-14f64baadc44",
"object": "trademark",
"mark_text": "COCA-COLA",
"mark_text_language": null,
"mark_text_script": null,
"mark_feature_type": "figurative",
"mark_legal_category": "standard",
"right_kind": "trademark",
"is_series_mark": null,
"series_count": null,
"status": {
"primary": "active",
"stage": "registered",
"reason": null,
"challenges": [],
"effective_date": "2022-09-27",
"source": "explicit",
"raw_code": "800",
"raw_label": null
},
"office_code": "uspto",
"jurisdiction_code": "US",
"filing_route": "direct_national",
"scope_kind": "national",
"origin_office_code": null,
"source_primary_id": "70022406",
"application_number": "70022406",
"registration_number": "0022406",
"ir_number": null,
"filing_date": "1892-05-14",
"registration_date": "1893-01-31",
"expiry_date": "2033-01-31",
"expiry_date_basis": "derived",
"renewal_due_date": "2033-01-31",
"publication_date": null,
"priority_date": null,
"termination_date": null,
"protection_effective_date": null,
"designation_date": null,
"dependency_period_end_date": null,
"transformation_deadline_date": null,
"is_retracted": false,
"owners": [
{
"id": "own_019d25f4-431a-72dc-a654-1c1acab5a3c4",
"name": "Coca Cola Company, The",
"country_code": null,
"entity_type": "corporation",
"role": "owner",
"address": {
"lines": ["One Coca-Cola Plaza"],
"city": "ATLANTA",
"state": "GA",
"postal_code": "30313",
"country_code": "US"
}
}
],
"attorneys": [
{
"id": "att_019d14a7-efe2-7015-a30c-11ac541fe714",
"name": "Katelyn Andrews",
"firm_id": "firm_ba9d8016-635a-4ca7-953c-ceab7e482e30",
"firm_name": "THE COCA-COLA COMPANY",
"role": "correspondent",
"address": {
"lines": ["One Coca-Cola Plaza"],
"city": "ATLANTA",
"state": "GA",
"postal_code": "30313",
"country_code": "US"
}
}
],
"classifications": [
{
"nice_class": 32,
"nice_edition": null,
"goods_services_text": null,
"goods_services_language": null,
"status": "accepted",
"class_status_raw": "6"
}
],
"design_codes": [],
"text_variants": [],
"statements": [
{
"type": "description",
"text": "The said trade-mark of said company consists of the word or words \"Coca Cola\".",
"language_code": null,
"applies_to_class": null
}
],
"media": [
{
"id": "med_c15633e7-ed08-45d2-8ea0-0de332cae378",
"media_type": "image",
"mime_type": "image/png",
"url": "https://api.signa.so/v1/trademarks/tm_019d14a7-efb6-754c-9a96-14f64baadc44/media/med_c15633e7-ed08-45d2-8ea0-0de332cae378",
"is_primary": true
}
],
"priority_claims": [],
"filing_bases": [
{
"basis_type": "use_in_commerce",
"nice_class_number": 32,
"first_use_date": "1887-06-28",
"first_use_in_commerce_date": "1887-06-28",
"foreign_application_number": null,
"foreign_country_code": null
}
],
"publications": [],
"office_extensions": {
"register_type": "principal"
},
"deadlines": [
{
"type": "combined_renewal_and_use",
"name": "Section 8+9 — Renewal + Declaration of Use",
"due_date": "2033-01-31",
"grace_expiry": "2033-07-31",
"window_opens": "2032-01-31",
"jurisdiction_code": "US",
"status": "future",
"urgency": "routine",
"days_until_due": 2484,
"consequence_if_missed": "cancellation_and_expiration"
}
],
"madrid": null,
"has_media": true,
"events_count": 21,
"proceedings_count": 0,
"coverage_count": 0,
"relationships_count": 0,
"data_freshness": {
"source_data_date": "2022-10-28",
"source_format": "dtd_v2",
"last_updated_at": "2026-03-30T02:13:13.704Z"
},
"created_at": "2026-03-22T08:27:23.446Z",
"updated_at": "2026-03-30T02:13:13.704Z",
"request_id": "req_01kp4v2yycy3pq3czhxcsmn9md"
}
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.
Path Parameters
Trademark ID (e.g.,
tm_019d14a7-efb6-754c-9a96-14f64baadc44)Response
Returns the full detail-tier representation of a trademark, including all bounded children (owners, attorneys, classifications, etc.) inline. Unbounded children (events, proceedings) appear as counts only.Prefixed trademark ID (
tm_*)Always
"trademark"Show Mark identification
Show Mark identification
Word mark as filed (null for design-only marks)
ISO 639-1 language code of the mark text
ISO 15924 script code
Mark feature type (e.g.,
word, figurative, combined)Legal category (e.g.,
standard, certification, collective)Right kind (
trademark, trade_name, geographical_indication, etc.)Whether the mark is a series mark
Number of marks in the series
Show Status
Show Status
Show Status object
Show Status object
Primary status:
active, pending, inactive, unknownLifecycle stage:
filed, examined, published, registered, renewed, abandoned, cancelled, expiredReason for current status (e.g.,
section_8_accepted)Active challenge states (e.g.,
opposition_pending, cancellation_pending)ISO date when this status became effective
How the status was determined:
office_code, event_history, inferredOffice-native status code (e.g.,
800)Office-native status label (e.g.,
Registered and renewed)Show Office and filing
Show Office and filing
Office code (e.g.,
uspto, euipo)ISO 2-letter jurisdiction (e.g.,
US, EU)Filing route (
direct_national, madrid_designation, etc.)Scope kind (
national, regional, international)Origin office for Madrid designations
Source system primary identifier
Application/serial number
Registration number
International registration number (Madrid system)
Show Key dates
Show Key dates
ISO date
ISO date
ISO date
Basis for expiry date calculation
ISO date
First publication date (ISO)
Earliest priority date (ISO), derived from priority claims
ISO date
ISO date
ISO date (Madrid designations)
ISO date (Madrid dependency period)
ISO date
Whether the record has been retracted by the source office
Show Owners
Show Owners
Show Owner object
Show Owner object
Owner ID (
own_*)Canonical owner name
ISO 2-letter country code
Entity type (e.g.,
corporation, individual)Owner role (e.g.,
owner, applicant)Show Attorneys
Show Attorneys
Show Attorney object
Show Attorney object
Attorney ID (
att_*)Canonical attorney name
Firm ID (
firm_*)Firm name
Attorney role (e.g.,
representative)Postal address as reported by the office. All fields optional; whole object is
null when no address is on file. Same shape as the owner address object.Show Classifications
Show Classifications
Show Classification object
Show Classification object
Nice class number (1—45)
Nice classification edition
Goods/services description
Language of the description
Class status
Raw class status from the office
Show Deadlines (computed)
Show Deadlines (computed)
Computed deadlines based on jurisdiction rules and the mark’s lifecycle dates.
Show Deadline object
Show Deadline object
Deadline type (e.g.,
renewal, declaration_of_use)Human-readable deadline name
ISO date when the deadline is due
ISO date when the grace period ends
ISO date when the filing window opens
Jurisdiction this deadline applies to
Deadline status:
upcoming, open, grace, overdue, pastUrgency level:
low, medium, high, criticalDays until the deadline (negative if overdue)
What happens if this deadline is missed
Show Other children
Show Other children
Vienna classification design codes
Alternative text representations of the mark
Disclaimers, descriptions of mark, etc.
Media files (images, sounds) with URLs. Each media object includes an
id with the med_ prefix (e.g. med_a39b4702-...), media_type, url, and content_type.Convention priority claims
Filing bases (US-specific: use in commerce, intent to use, etc.)
Publication history (gazette/journal entries)
Office-specific data not captured by the standard schema
Madrid system enrichment data (only for international registrations)
Show Counts and metadata
Show Counts and metadata
Whether the mark has any media files
Total number of events (fetch via
/v1/trademarks/{id}/history)Total number of proceedings
Total number of coverage entries
Total number of relationships
ISO timestamp
ISO timestamp
Unique request identifier
{
"id": "tm_019d14a7-efb6-754c-9a96-14f64baadc44",
"object": "trademark",
"mark_text": "COCA-COLA",
"mark_text_language": null,
"mark_text_script": null,
"mark_feature_type": "figurative",
"mark_legal_category": "standard",
"right_kind": "trademark",
"is_series_mark": null,
"series_count": null,
"status": {
"primary": "active",
"stage": "registered",
"reason": null,
"challenges": [],
"effective_date": "2022-09-27",
"source": "explicit",
"raw_code": "800",
"raw_label": null
},
"office_code": "uspto",
"jurisdiction_code": "US",
"filing_route": "direct_national",
"scope_kind": "national",
"origin_office_code": null,
"source_primary_id": "70022406",
"application_number": "70022406",
"registration_number": "0022406",
"ir_number": null,
"filing_date": "1892-05-14",
"registration_date": "1893-01-31",
"expiry_date": "2033-01-31",
"expiry_date_basis": "derived",
"renewal_due_date": "2033-01-31",
"publication_date": null,
"priority_date": null,
"termination_date": null,
"protection_effective_date": null,
"designation_date": null,
"dependency_period_end_date": null,
"transformation_deadline_date": null,
"is_retracted": false,
"owners": [
{
"id": "own_019d25f4-431a-72dc-a654-1c1acab5a3c4",
"name": "Coca Cola Company, The",
"country_code": null,
"entity_type": "corporation",
"role": "owner",
"address": {
"lines": ["One Coca-Cola Plaza"],
"city": "ATLANTA",
"state": "GA",
"postal_code": "30313",
"country_code": "US"
}
}
],
"attorneys": [
{
"id": "att_019d14a7-efe2-7015-a30c-11ac541fe714",
"name": "Katelyn Andrews",
"firm_id": "firm_ba9d8016-635a-4ca7-953c-ceab7e482e30",
"firm_name": "THE COCA-COLA COMPANY",
"role": "correspondent",
"address": {
"lines": ["One Coca-Cola Plaza"],
"city": "ATLANTA",
"state": "GA",
"postal_code": "30313",
"country_code": "US"
}
}
],
"classifications": [
{
"nice_class": 32,
"nice_edition": null,
"goods_services_text": null,
"goods_services_language": null,
"status": "accepted",
"class_status_raw": "6"
}
],
"design_codes": [],
"text_variants": [],
"statements": [
{
"type": "description",
"text": "The said trade-mark of said company consists of the word or words \"Coca Cola\".",
"language_code": null,
"applies_to_class": null
}
],
"media": [
{
"id": "med_c15633e7-ed08-45d2-8ea0-0de332cae378",
"media_type": "image",
"mime_type": "image/png",
"url": "https://api.signa.so/v1/trademarks/tm_019d14a7-efb6-754c-9a96-14f64baadc44/media/med_c15633e7-ed08-45d2-8ea0-0de332cae378",
"is_primary": true
}
],
"priority_claims": [],
"filing_bases": [
{
"basis_type": "use_in_commerce",
"nice_class_number": 32,
"first_use_date": "1887-06-28",
"first_use_in_commerce_date": "1887-06-28",
"foreign_application_number": null,
"foreign_country_code": null
}
],
"publications": [],
"office_extensions": {
"register_type": "principal"
},
"deadlines": [
{
"type": "combined_renewal_and_use",
"name": "Section 8+9 — Renewal + Declaration of Use",
"due_date": "2033-01-31",
"grace_expiry": "2033-07-31",
"window_opens": "2032-01-31",
"jurisdiction_code": "US",
"status": "future",
"urgency": "routine",
"days_until_due": 2484,
"consequence_if_missed": "cancellation_and_expiration"
}
],
"madrid": null,
"has_media": true,
"events_count": 21,
"proceedings_count": 0,
"coverage_count": 0,
"relationships_count": 0,
"data_freshness": {
"source_data_date": "2022-10-28",
"source_format": "dtd_v2",
"last_updated_at": "2026-03-30T02:13:13.704Z"
},
"created_at": "2026-03-22T08:27:23.446Z",
"updated_at": "2026-03-30T02:13:13.704Z",
"request_id": "req_01kp4v2yycy3pq3czhxcsmn9md"
}
⌘I