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. The bases are the ones the application was filed on; a later change, such as a statement of use or an added Section 44(e) basis, is not reflected.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. Filing bases are recorded as filed, so a registered mark that started as an intent-to-use application still shows intent_to_use. Check status for whether it registered.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. Every owner has an id (e.g., own_abc123), name, country_code, legal_form and entity_id (the linked entity, null when the owner is not linked); the detail tier adds role, is_current and address (postal address as reported by the office, or null).Legal Form
Legal Form
legal_form on owner objects within the owners[] array, and on owner, attorney-client and entity resources (including entity members[]). GET /v1/owners and GET /v1/entities filter on it with legal_form. Signa maps 75+ office-specific entity-type codes to normalized values; null when the office states none.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 are top-level on the detail tier: ir_number, origin_office_code, filing_route, designation_date, dependency_period_end_date, and transformation_deadline_date. There is no nested madrid object: the family view is the inline coverage block (per-territory rollup, present on IR parents, null on designation legs), and other mark-to-mark links are in relationships[].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)
derived.deadlines.items on every trademark row with type: "declaration_of_use". Includes due_date, grace_expiry_date, window_opens, and consequence_if_missed: "cancellation".Declaration of Incontestability (Section 15)
Declaration of Incontestability (Section 15)
derived.deadlines.items with type: "declaration_of_incontestability" and is_optional: true. Note that consequence_if_missed is "none" since this is an optional filing.Renewal
Renewal
renewal_due_date is the renewal due date the office published (null when it published none); filterable via ?renewal_due_date_gte=2026-01-01&renewal_due_date_lt=2027-01-01. The computed schedule is derived.deadlines.items, with due_date, grace_expiry_date and window_opens for every renewal.Grace Period
Grace Period
grace_expiry_date on each deadline row, and derived.term.grace_expiry_date for the grace period after the term on record (derived.term.state is in_grace while it runs). On Compute Deadlines the status field 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 status_raw (the office’s {code, label}) 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 system (vienna, us_design_search or other), code, 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.