Overview
Trademarks
Entities
Portfolios
Watches & Alerts
Reference Data
Get Trademark
Copy
curl --request GET \
--url https://api.example.com/v1/trademarks/{id}Copy
{
"id": "tm_abc123",
"object": "trademark",
"mark_text": "SIGNA",
"mark_text_language": "en",
"mark_text_script": null,
"mark_feature_type": "word",
"mark_legal_category": "standard",
"right_kind": "trademark",
"is_series_mark": false,
"series_count": null,
"status": {
"primary": "active",
"stage": "registered",
"reason": null,
"challenges": [],
"effective_date": "2025-01-20",
"source": "office_code",
"raw_code": "800",
"raw_label": "Registered and renewed"
},
"office_code": "uspto",
"jurisdiction_code": "US",
"filing_route": "direct_national",
"scope_kind": "national",
"origin_office_code": null,
"source_primary_id": "98765432",
"application_number": "98765432",
"registration_number": "7654321",
"ir_number": null,
"filing_date": "2024-06-15",
"registration_date": "2025-01-20",
"expiry_date": "2035-01-20",
"expiry_date_basis": "registration",
"renewal_due_date": "2035-01-20",
"publication_date": "2024-11-05",
"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": "ow_def456",
"name": "Signa Technologies Inc.",
"country_code": "US",
"entity_type": "corporation",
"role": "owner"
}
],
"attorneys": [
{
"id": "att_ghi789",
"name": "Jane Smith",
"firm_id": "fm_jkl012",
"firm_name": "Smith & Associates IP",
"role": "representative"
}
],
"classifications": [
{
"nice_class": 9,
"nice_edition": "12",
"goods_services_text": "Computer software for trademark monitoring and analysis",
"goods_services_language": "en",
"status": null,
"class_status_raw": null
},
{
"nice_class": 42,
"nice_edition": "12",
"goods_services_text": "Software as a service (SaaS) for trademark portfolio management",
"goods_services_language": "en",
"status": null,
"class_status_raw": null
}
],
"design_codes": [],
"text_variants": [],
"statements": [
{
"type": "disclaimer",
"text": "No claim is made to the exclusive right to use \"TECHNOLOGIES\" apart from the mark as shown.",
"language_code": "en",
"applies_to_class": null
}
],
"media": [],
"priority_claims": [],
"filing_bases": [
{
"basis_type": "use_in_commerce",
"nice_class_number": 9,
"first_use_date": "2024-01-10",
"first_use_in_commerce_date": "2024-03-15",
"foreign_application_number": null,
"foreign_country_code": null
}
],
"publications": [
{
"publication_type": "opposition",
"publication_date": "2024-11-05",
"bulletin_number": null,
"source_reference": null,
"opposition_period_start": "2024-11-05",
"opposition_period_end": "2025-01-04"
}
],
"office_extensions": {},
"deadlines": [
{
"type": "declaration_of_use",
"name": "Section 8 Declaration of Use",
"due_date": "2031-01-20",
"grace_expiry": "2031-07-20",
"window_opens": "2030-01-20",
"jurisdiction_code": "US",
"status": "upcoming",
"urgency": "low",
"days_until_due": 1763,
"consequence_if_missed": "Registration cancelled"
}
],
"madrid": null,
"has_media": false,
"events_count": 12,
"proceedings_count": 0,
"coverage_count": 0,
"relationships_count": 0,
"data_freshness": {
"source_data_date": "2026-03-23",
"source_format": "dtd_v2",
"last_updated_at": "2026-03-24T06:15:00.000Z"
},
"created_at": "2024-08-01T10:30:00.000Z",
"updated_at": "2026-03-24T06:15:00.000Z",
"livemode": true,
"request_id": "req_xyz789"
}
Trademarks
Get Trademark
Retrieve a single trademark by ID
GET
/
v1
/
trademarks
/
{id}
Get Trademark
Copy
curl --request GET \
--url https://api.example.com/v1/trademarks/{id}Copy
{
"id": "tm_abc123",
"object": "trademark",
"mark_text": "SIGNA",
"mark_text_language": "en",
"mark_text_script": null,
"mark_feature_type": "word",
"mark_legal_category": "standard",
"right_kind": "trademark",
"is_series_mark": false,
"series_count": null,
"status": {
"primary": "active",
"stage": "registered",
"reason": null,
"challenges": [],
"effective_date": "2025-01-20",
"source": "office_code",
"raw_code": "800",
"raw_label": "Registered and renewed"
},
"office_code": "uspto",
"jurisdiction_code": "US",
"filing_route": "direct_national",
"scope_kind": "national",
"origin_office_code": null,
"source_primary_id": "98765432",
"application_number": "98765432",
"registration_number": "7654321",
"ir_number": null,
"filing_date": "2024-06-15",
"registration_date": "2025-01-20",
"expiry_date": "2035-01-20",
"expiry_date_basis": "registration",
"renewal_due_date": "2035-01-20",
"publication_date": "2024-11-05",
"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": "ow_def456",
"name": "Signa Technologies Inc.",
"country_code": "US",
"entity_type": "corporation",
"role": "owner"
}
],
"attorneys": [
{
"id": "att_ghi789",
"name": "Jane Smith",
"firm_id": "fm_jkl012",
"firm_name": "Smith & Associates IP",
"role": "representative"
}
],
"classifications": [
{
"nice_class": 9,
"nice_edition": "12",
"goods_services_text": "Computer software for trademark monitoring and analysis",
"goods_services_language": "en",
"status": null,
"class_status_raw": null
},
{
"nice_class": 42,
"nice_edition": "12",
"goods_services_text": "Software as a service (SaaS) for trademark portfolio management",
"goods_services_language": "en",
"status": null,
"class_status_raw": null
}
],
"design_codes": [],
"text_variants": [],
"statements": [
{
"type": "disclaimer",
"text": "No claim is made to the exclusive right to use \"TECHNOLOGIES\" apart from the mark as shown.",
"language_code": "en",
"applies_to_class": null
}
],
"media": [],
"priority_claims": [],
"filing_bases": [
{
"basis_type": "use_in_commerce",
"nice_class_number": 9,
"first_use_date": "2024-01-10",
"first_use_in_commerce_date": "2024-03-15",
"foreign_application_number": null,
"foreign_country_code": null
}
],
"publications": [
{
"publication_type": "opposition",
"publication_date": "2024-11-05",
"bulletin_number": null,
"source_reference": null,
"opposition_period_start": "2024-11-05",
"opposition_period_end": "2025-01-04"
}
],
"office_extensions": {},
"deadlines": [
{
"type": "declaration_of_use",
"name": "Section 8 Declaration of Use",
"due_date": "2031-01-20",
"grace_expiry": "2031-07-20",
"window_opens": "2030-01-20",
"jurisdiction_code": "US",
"status": "upcoming",
"urgency": "low",
"days_until_due": 1763,
"consequence_if_missed": "Registration cancelled"
}
],
"madrid": null,
"has_media": false,
"events_count": 12,
"proceedings_count": 0,
"coverage_count": 0,
"relationships_count": 0,
"data_freshness": {
"source_data_date": "2026-03-23",
"source_format": "dtd_v2",
"last_updated_at": "2026-03-24T06:15:00.000Z"
},
"created_at": "2024-08-01T10:30:00.000Z",
"updated_at": "2026-03-24T06:15:00.000Z",
"livemode": true,
"request_id": "req_xyz789"
}
Path Parameters
Trademark ID (e.g.,
tm_abc123)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, deadLifecycle 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 Attorneys
Show Attorneys
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
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}/events)Total number of proceedings
Total number of coverage entries
Total number of relationships
ISO timestamp
ISO timestamp
Whether this is live or test mode data
Unique request identifier
Copy
{
"id": "tm_abc123",
"object": "trademark",
"mark_text": "SIGNA",
"mark_text_language": "en",
"mark_text_script": null,
"mark_feature_type": "word",
"mark_legal_category": "standard",
"right_kind": "trademark",
"is_series_mark": false,
"series_count": null,
"status": {
"primary": "active",
"stage": "registered",
"reason": null,
"challenges": [],
"effective_date": "2025-01-20",
"source": "office_code",
"raw_code": "800",
"raw_label": "Registered and renewed"
},
"office_code": "uspto",
"jurisdiction_code": "US",
"filing_route": "direct_national",
"scope_kind": "national",
"origin_office_code": null,
"source_primary_id": "98765432",
"application_number": "98765432",
"registration_number": "7654321",
"ir_number": null,
"filing_date": "2024-06-15",
"registration_date": "2025-01-20",
"expiry_date": "2035-01-20",
"expiry_date_basis": "registration",
"renewal_due_date": "2035-01-20",
"publication_date": "2024-11-05",
"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": "ow_def456",
"name": "Signa Technologies Inc.",
"country_code": "US",
"entity_type": "corporation",
"role": "owner"
}
],
"attorneys": [
{
"id": "att_ghi789",
"name": "Jane Smith",
"firm_id": "fm_jkl012",
"firm_name": "Smith & Associates IP",
"role": "representative"
}
],
"classifications": [
{
"nice_class": 9,
"nice_edition": "12",
"goods_services_text": "Computer software for trademark monitoring and analysis",
"goods_services_language": "en",
"status": null,
"class_status_raw": null
},
{
"nice_class": 42,
"nice_edition": "12",
"goods_services_text": "Software as a service (SaaS) for trademark portfolio management",
"goods_services_language": "en",
"status": null,
"class_status_raw": null
}
],
"design_codes": [],
"text_variants": [],
"statements": [
{
"type": "disclaimer",
"text": "No claim is made to the exclusive right to use \"TECHNOLOGIES\" apart from the mark as shown.",
"language_code": "en",
"applies_to_class": null
}
],
"media": [],
"priority_claims": [],
"filing_bases": [
{
"basis_type": "use_in_commerce",
"nice_class_number": 9,
"first_use_date": "2024-01-10",
"first_use_in_commerce_date": "2024-03-15",
"foreign_application_number": null,
"foreign_country_code": null
}
],
"publications": [
{
"publication_type": "opposition",
"publication_date": "2024-11-05",
"bulletin_number": null,
"source_reference": null,
"opposition_period_start": "2024-11-05",
"opposition_period_end": "2025-01-04"
}
],
"office_extensions": {},
"deadlines": [
{
"type": "declaration_of_use",
"name": "Section 8 Declaration of Use",
"due_date": "2031-01-20",
"grace_expiry": "2031-07-20",
"window_opens": "2030-01-20",
"jurisdiction_code": "US",
"status": "upcoming",
"urgency": "low",
"days_until_due": 1763,
"consequence_if_missed": "Registration cancelled"
}
],
"madrid": null,
"has_media": false,
"events_count": 12,
"proceedings_count": 0,
"coverage_count": 0,
"relationships_count": 0,
"data_freshness": {
"source_data_date": "2026-03-23",
"source_format": "dtd_v2",
"last_updated_at": "2026-03-24T06:15:00.000Z"
},
"created_at": "2024-08-01T10:30:00.000Z",
"updated_at": "2026-03-24T06:15:00.000Z",
"livemode": true,
"request_id": "req_xyz789"
}
⌘I