List Opposition Rules

List all opposition window rules across modeled offices

GET /v1/opposition-rules

List Opposition Rules

cURL

curl --request GET \
  --url https://api.signa.so/v1/opposition-rules \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "object": "opposition_rule",
      "jurisdiction_code": "EU",
      "office_code": "euipo",
      "filing_route": "madrid_designation",
      "trigger_event": "international_designation_publication",
      "window_months": 3,
      "window_days": null,
      "window_starts_offset_months": 1,
      "window_starts_on": "day_after",
      "office_time_zone": "Europe/Madrid",
      "holiday_calendar": "euipo_alicante",
      "common_extension": null,
      "applicable_from_date": null,
      "sources": [
        {
          "citation": "Article 196(2) EUTMR",
          "url": "https://eur-lex.europa.eu/eli/reg/2017/1001"
        }
      ]
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null }
}

Overview

Returns a flat list of opposition window rules — the statutory windows during which third parties may oppose a published trademark application or registration. Each rule includes the office’s local time zone, holiday calendar (used for close-date rollover), statutory citations, and any common (non-statutory but routinely granted) extensions.

Composite key: each rule is uniquely identified by (office_code, filing_route, trigger_event).

This endpoint exposes the same rule corpus that powers the opposition_window field on a trademark detail response. Use it to build educational UI, surface citations alongside a watch alert, or document what your customers can expect for a given office.

Query Parameters

jurisdiction · string

Filter by jurisdiction code (uppercase ISO-2). Comma-separated for multiple values.

office · string

Filter by office code (lowercase, as returned by /v1/offices). Comma-separated for multiple values, e.g. ?office=uspto,euipo.

filing_route · string

Filter by the rule’s filing route discriminator. Accepted values: domestic, madrid_designation. Comma-separated for multiple values.

trigger_event · string

Filter by trigger event. Accepted values: application_publication, registration_publication, international_designation_publication. Comma-separated for multiple values.

Response

A standard list response with data: OppositionRule[]. The corpus is small (~24 rules today) and is returned in a single page.

object · string

Always list

data · object[]

Show OppositionRule

object · string

Always opposition_rule

jurisdiction_code · string

Jurisdiction (uppercase ISO-2)

office_code · string

Office (lowercase, e.g. uspto, euipo, cipo)

filing_route · string

Either domestic or madrid_designation

trigger_event · string

Which event starts the opposition clock: application_publication, registration_publication, or international_designation_publication

window_months · integer | null

Window duration in months (null when expressed in days)

window_days · integer | null

Window duration in days (null when expressed in months)

window_starts_offset_months · integer | null

Months to wait after publication before the window opens (e.g. EUIPO Madrid-EU = 1 month between Bulletin Part M republication and window opening)

window_starts_on · string

Either date_of_publication or day_after

office_time_zone · string

IANA office time zone (display-only — date math uses calendar dates)

holiday_calendar · string | null

Holiday calendar key used for close-date rollover, e.g. uspto_dc

common_extension · object | null

Show Extension

days · integer | null

Extension length in days

months · integer | null

Extension length in months

as_of_right · boolean

true if granted automatically on timely request, false if discretionary but routinely granted

notes · string

Human-readable note for UI surfacing

applicable_from_date · string | null

Marks published before this date use a different rule (null = always applies)

sources · object[]

Show RuleSource

citation · string

Statutory citation, e.g. Article 196(2) EUTMR

url · string

Authoritative URL for the citation

has_more · boolean

Always false

pagination · object

Standard pagination envelope (cursor: null)

{
  "object": "list",
  "data": [
    {
      "object": "opposition_rule",
      "jurisdiction_code": "EU",
      "office_code": "euipo",
      "filing_route": "madrid_designation",
      "trigger_event": "international_designation_publication",
      "window_months": 3,
      "window_days": null,
      "window_starts_offset_months": 1,
      "window_starts_on": "day_after",
      "office_time_zone": "Europe/Madrid",
      "holiday_calendar": "euipo_alicante",
      "common_extension": null,
      "applicable_from_date": null,
      "sources": [
        {
          "citation": "Article 196(2) EUTMR",
          "url": "https://eur-lex.europa.eu/eli/reg/2017/1001"
        }
      ]
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null }
}

Code Examples

cURL

curl "https://api.signa.so/v1/opposition-rules?office=euipo" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx"

Errors

Status	Type	Description
400	validation_error	Invalid filing_route or trigger_event value
401	unauthorized	Missing or invalid API key
403	forbidden	API key missing the trademarks:read scope
429	rate_limited	Too many requests

Related Endpoints

• List Deadline Rules — maintenance deadline rules (renewals, declarations)
• List Offices — office overview