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>'

import requests

url = "https://api.signa.so/v1/opposition-rules"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.signa.so/v1/opposition-rules', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.signa.so/v1/opposition-rules",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.signa.so/v1/opposition-rules"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.signa.so/v1/opposition-rules")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/opposition-rules")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "opposition_rule",
      "jurisdiction_code": "EU",
      "office_code": "EM",
      "filing_route": "madrid_designation",
      "trigger_event": "international_designation_publication",
      "window_months": 3,
      "window_days": null,
      "window_starts_offset_months": 1,
      "window_starts_on": "date_of_publication",
      "office_time_zone": "Europe/Madrid",
      "holiday_calendar": "euipo_alicante",
      "common_extension": null,
      "applicable_from_date": null,
      "sources": [
        {
          "citation": "Article 196(2) EUTMR (Regulation (EU) 2017/1001)",
          "url": "https://eur-lex.europa.eu/eli/reg/2017/1001/oj/eng"
        }
      ]
    }
  ],
  "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.

Each rule is uniquely identified by the combination of office_code, filing_route, and trigger_event.

This endpoint exposes the same rule corpus that powers Compute Oppositions and the opposition_window field on a trademark detail response. Use it to build educational UI, surface citations alongside a watch alert, or document what to 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 uppercase ST.3 office code (as returned by /v1/offices). Comma-separated for multiple values, e.g. ?office=US,EM. Legacy lowercase codes (e.g. uspto, and eu for EUIPO) are accepted as permanent aliases.

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 and returned in a single page. This endpoint is publicly cacheable, so the response never includes request_id.

object · string

Always list

data · object[]

Show OppositionRule

object · string

Always opposition_rule

jurisdiction_code · string

Jurisdiction (uppercase ISO-2)

office_code · string

Uppercase ST.3 office code (e.g. US, EM, CA)

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 has 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 means the rule 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": "EM",
      "filing_route": "madrid_designation",
      "trigger_event": "international_designation_publication",
      "window_months": 3,
      "window_days": null,
      "window_starts_offset_months": 1,
      "window_starts_on": "date_of_publication",
      "office_time_zone": "Europe/Madrid",
      "holiday_calendar": "euipo_alicante",
      "common_extension": null,
      "applicable_from_date": null,
      "sources": [
        {
          "citation": "Article 196(2) EUTMR (Regulation (EU) 2017/1001)",
          "url": "https://eur-lex.europa.eu/eli/reg/2017/1001/oj/eng"
        }
      ]
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null }
}

Code Examples

cURL

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

import { Signa } from "@signa-so/sdk";

const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

const rules = await signa.references.oppositionRules({ office: "EM" });
for (const rule of rules.data) {
  console.log(rule.office_code, rule.filing_route, rule.window_months);
}

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

• Compute Oppositions, compute per-publication opposition windows from these rules
• List Deadline Rules, maintenance deadline rules (renewals, declarations)
• List Offices, office overview