Territory and scope
Jurisdiction vs Office
Jurisdiction vs Office
jurisdictions selects rights that protect, or seek protection, in a territory (protection-scope by default, so jurisdictions=FR also returns EU trade marks). offices selects the register a mark was filed with. Jurisdiction codes are uppercase ISO/region codes (US, EU); office codes are WIPO ST.3 codes (US, EM for the EUIPO), with legacy lowercase aliases (uspto, eu). See Search Trademarks for territory_match, which controls how far jurisdictions expands.The three shapes of a trademark right
The three shapes of a trademark right
- National right: filed directly with a national office and protecting that one country (a USPTO registration protects the US,
jurisdiction_code: "US",filing_route: "direct_national"). - Regional unitary right: a single right filed with a regional office that protects every member of that region as one indivisible unit. The three modeled regions are the EU trade mark (EUIPO,
jurisdiction_code: "EU"), the Benelux mark (BX, covering Belgium, the Netherlands, and Luxembourg), and the OAPI mark (OA, covering its African member states).filing_route: "direct_regional". - Madrid designation: a per-country request for protection extended from a WIPO international registration to one designated territory, examined independently by that territory’s office (
filing_route: "madrid_designation", the designated country asjurisdiction_code). One IR fans out into many designations.
filing_route. Under protection-scope jurisdictions matching, a request for a country matches national rights, Madrid designations of that country, and any regional unitary right whose membership covers it.EUTM territorial scope (EU-27 only)
EUTM territorial scope (EU-27 only)
jurisdictions expansion maps a EUTM onto its 27 member states but never onto GB, CH, or NO. A request for one of those territories will never pull in a EUTM on membership grounds. Seniority claims on a EUTM are metadata only and never widen its geographic scope (see the Seniority entry under International below).Filing
Application Number
Application Number
97123456, EUIPO numbers like 018765432).In the API: application_number on trademark objects. Requires office_code for uniqueness since different offices may reuse number formats. Use with GET /v1/trademarks?application_number=97123456&office=US.Filing Date
Filing Date
filing_date on all trademark tiers. Sortable via ?sort=-filing_date. Filterable via ?filing_date_gte=2025-01-01.Filing Basis
Filing Basis
filing_bases[] array in the detail tier. Each entry has a basis_type (one of use_in_commerce, intent_to_use, foreign_application, foreign_registration, madrid_extension, no_basis), optionally scoped to a specific Nice class.Filing Route
Filing Route
filing_route on summary and detail tiers. Values: direct_national, direct_regional, madrid_designation, transformation, divisional, unknown. Filterable via ?filing_route=madrid_designation. Use ?is_madrid=true as shorthand for all Madrid Protocol marks.Intent-to-Use (ITU)
Intent-to-Use (ITU)
basis_type: "intent_to_use" in the filing_bases[] array on the detail tier.Priority Claim
Priority Claim
priority_claims[] array in the detail tier. Each entry includes priority_type (e.g., paris), country_code, application_number, and priority_date. The convenience field priority_date on the detail tier shows the earliest priority date.Status
Status Stage
Status Stage
status.stage on all tiers. Stages: filed, examining, pending_publication, published, opposition_period, pending_opposition, pending_cancellation, pending_issuance, registered, allowed, abandoned, withdrawn, surrendered, refused, cancelled, invalidated, expired, unknown. Filterable via ?status_stage=registered,published.Status Primary
Status Primary
stage gives the specific lifecycle position, primary groups stages into broader categories.In the API: status.primary on summary and detail tiers. Values: pending, active, inactive, unknown. For example, registered stage maps to active primary.Opposition Period
Opposition Period
status.stage: "opposition_period" indicates the mark is currently in this window. The publications[] array on the detail tier includes opposition_period_start and opposition_period_end dates.Abandonment
Abandonment
status.stage: "abandoned". The status.reason field may provide additional context when available from the office.Ownership
Owner
Owner
owners[] array on every trademark, detail and summary tiers alike. The detail tier’s owner has an id (e.g., own_abc123), name, country_code, entity_type, role, and address (postal address as reported by the office, or null); the summary tier’s owner is a lighter projection (id, name, country_code, resolved entity_id).Entity Type
Entity Type
entity_type on owner objects within the owners[] array. Signa maps 75+ office-specific entity codes to normalized values.Entity Resolution
Entity Resolution
id. The GET /v1/owners/{id} endpoint returns the canonical profile including aliases[] (alternative name forms) and aggregate statistics across all jurisdictions.Corporate Parent
Corporate Parent
GET /v1/owners/{id}/related returns parent and subsidiary relationships. Each relationship includes relationship_type (e.g., IS_DIRECTLY_CONSOLIDATED_BY), ownership_pct, and period_start/period_end.International
Madrid Protocol
Madrid Protocol
filing_route: "madrid_designation". Use ?is_madrid=true to filter for all Madrid Protocol marks. Madrid-specific fields include ir_number, designation_date, dependency_period_end_date, and transformation_deadline_date on the detail tier. The madrid object on the detail tier contains the parent IR metadata.Designation
Designation
filing_route: "madrid_designation" and the designated country as jurisdiction_code. The ir_number links all designations from the same international registration. Use ?ir_number=1234567 to find all designations from one IR.International Registration (IR) Number
International Registration (IR) Number
ir_number on summary and detail tiers. Filterable directly: GET /v1/trademarks?ir_number=1234567. Also accepted by the batch endpoint without requiring an office parameter (IR numbers are globally unique).Seniority
Seniority
office_extensions object on EUIPO detail-tier records when present.Dependency Period
Dependency Period
dependency_period_end_date on the detail tier for Madrid marks. After this date, the IR stands independently.Procedural
Opposition
Opposition
status.stage: "pending_opposition" when an opposition has been filed. TTAB proceedings data is available via GET /v1/trademarks/{id}/proceedings for US marks.Cancellation
Cancellation
status.stage: "cancelled" or "pending_cancellation". Cancellation proceedings appear in the proceedings sub-resource.Declaration of Use (Section 8)
Declaration of Use (Section 8)
deadlines[] array on the detail tier with type: "declaration_of_use". Includes due_date, grace_expiry, window_opens, and consequence_if_missed: "cancellation".Declaration of Incontestability (Section 15)
Declaration of Incontestability (Section 15)
deadlines[] array with type: "declaration_of_incontestability". Note that consequence_if_missed is "none" since this is an optional filing.Renewal
Renewal
renewal_due_date is a first-class field on summary and detail tiers. The deadlines[] array provides full renewal detail including grace_expiry and window_opens. Filterable via ?renewal_due_date_gte=2026-01-01&renewal_due_date_lt=2027-01-01.Grace Period
Grace Period
grace_expiry in the deadlines[] array. null when no grace period exists. The status field on each deadline can be in_grace when the mark is currently in a grace period.Classification
Nice Classification
Nice Classification
classifications[] array on both summary and detail tiers. Each entry includes nice_class and goods_services_text on the summary tier, and adds nice_edition, goods_services_language, status, and class_status_raw on the detail tier. Filterable via ?nice_classes=9,42.Vienna Classification
Vienna Classification
26.04.01 for “globe”). Used primarily for searching design marks.In the API: design_codes[] array on the detail tier. Each entry has code_system: "vienna", code_value, and edition. Searchable via the search endpoint’s filter parameters.Mark Feature Type
Mark Feature Type
mark_feature_type on summary and detail tiers. Values include word, figurative, combined, three_d, color, sound, motion, hologram, pattern, position, multimedia, scent, taste, texture, other, unknown. Filterable via ?mark_feature_type=word,combined.Mark Legal Category
Mark Legal Category
mark_legal_category on summary and detail tiers. Values: standard, collective, certification, collective_membership, defensive, guarantee, geographical_indication, other, unknown. Filterable via ?mark_legal_category=certification.Right Kind
Right Kind
right_kind on summary and detail tiers. Values: trademark, trade_name, commercial_notice, geographical_indication, other.Goods and Services Description
Goods and Services Description
goods_services_text within each entry of the classifications[] array on the detail tier. Language indicated by goods_services_language.