Compute Oppositions

curl --request POST \
  --url https://api.signa.so/v1/oppositions/compute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "office": "<string>",
      "filing_route": "<string>",
      "publication_date": "<string>"
    }
  ],
  "as_of_date": "<string>"
}
'

{
  "object": "list",
  "data": [
    {
      "object": "opposition_window",
      "supported": true,
      "unsupported_reason": null,
      "jurisdiction_code": "EU",
      "office_code": "euipo",
      "filing_route": "domestic",
      "publication_date": "2026-05-01",
      "window_opens": "2026-05-02",
      "window_closes": "2026-08-03",
      "status": "open",
      "days_until_open": null,
      "days_remaining": 29,
      "office_time_zone": "Europe/Madrid",
      "trigger_event": "application_publication",
      "rule_version": "2026-05-06",
      "common_extension": null,
      "source": {
        "citation": "Article 46(1) EUTMR (Regulation (EU) 2017/1001)",
        "url": "https://eur-lex.europa.eu/eli/reg/2017/1001/oj/eng"
      }
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_bT9kM3nP"
}

POST

oppositions

compute

Compute Oppositions

curl --request POST \
  --url https://api.signa.so/v1/oppositions/compute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "office": "<string>",
      "filing_route": "<string>",
      "publication_date": "<string>"
    }
  ],
  "as_of_date": "<string>"
}
'

{
  "object": "list",
  "data": [
    {
      "object": "opposition_window",
      "supported": true,
      "unsupported_reason": null,
      "jurisdiction_code": "EU",
      "office_code": "euipo",
      "filing_route": "domestic",
      "publication_date": "2026-05-01",
      "window_opens": "2026-05-02",
      "window_closes": "2026-08-03",
      "status": "open",
      "days_until_open": null,
      "days_remaining": 29,
      "office_time_zone": "Europe/Madrid",
      "trigger_event": "application_publication",
      "rule_version": "2026-05-06",
      "common_extension": null,
      "source": {
        "citation": "Article 46(1) EUTMR (Regulation (EU) 2017/1001)",
        "url": "https://eur-lex.europa.eu/eli/reg/2017/1001/oj/eng"
      }
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_bT9kM3nP"
}

Overview

Compute opposition windows for one or more publication dates without persisting data. Watch and brand-protection buyers use this when a conflicting mark publishes and the oppose-by date decides whether they oppose now, while the filing is cheap and procedural, or cancel later, when the matter is expensive and uncertain. Opposition windows are short, unforgiving, and jurisdiction-specific. Use the companion List Opposition Rules endpoint when you need to inspect the office rules, trigger events, time zones, extensions, and citations that power these computations.

Reference → Oppositions is the forward-looking WINDOW/timing computed from a publication date. Records → Proceedings (per-mark) is actual filed opposition CASES. They are distinct.

Request Body

items

object[]

required

Publications to compute, max 1,000 items. Results are returned in the same order, with one opposition_window per input item.

Show Item object

office

string

required

Trademark office code, e.g. uspto, euipo, or cipo. Values are normalized to lowercase.

filing_route

string

Filing route. One of national, regional, or madrid. Defaults to national. The response reports the office rule discriminator as domestic or madrid_designation.

publication_date

string

Publication calendar date as YYYY-MM-DD. Omit when the publication date is unknown; the response status will be unknown.

as_of_date

string

Office-local calendar date to compute relative to, as YYYY-MM-DD. Defaults to today.

Response

A standard list response with data: OppositionWindowComputation[]. Pagination is not used; data[i] corresponds to items[i].

object

string

Always list.

data

object[]

Show OppositionWindowComputation

object

string

Always opposition_window.

supported

boolean

true when Signa has an opposition rule for the office and route.

unsupported_reason

string | null

unsupported_office, window_not_computable, or null.

jurisdiction_code

string | null

Jurisdiction for the office rule, e.g. EU.

office_code

string | null

Office code used for the computation, e.g. euipo.

filing_route

string | null

Rule discriminator: domestic or madrid_designation.

publication_date

string | null

Publication date used as the trigger.

window_opens

string | null

First day the opposition window is open.

window_closes

string | null

Last day to oppose, after office-calendar rollover.

status

string | null

One of not_started, open, closed, or unknown.

days_until_open

integer | null

Days until window_opens when the status is not_started.

days_remaining

integer | null

Days remaining in the window when known.

office_time_zone

string | null

IANA office time zone for display.

trigger_event

string | null

application_publication, registration_publication, or international_designation_publication.

rule_version

string | null

Date the office rule was last verified.

common_extension

object | null

Show CommonExtension

days

integer | null

Extension length in days.

months

integer | null

Extension length in months.

as_of_right

boolean

Whether the extension is granted automatically on timely request.

notes

string

Human-readable note for UI surfacing.

source

object | null

Show Source

citation

string

Statutory or office citation.

url

string

Authoritative URL for the citation.

has_more

boolean

Always false.

pagination

object

Always { "cursor": null }.

request_id

string

Unique request identifier for support and debugging.

Unsupported offices or unsupported office-route combinations return supported: false with nullable window fields. A far-future or out-of-calendar-range item that cannot be rolled forward returns unsupported_reason: "window_not_computable" for that item only.

{
  "object": "list",
  "data": [
    {
      "object": "opposition_window",
      "supported": true,
      "unsupported_reason": null,
      "jurisdiction_code": "EU",
      "office_code": "euipo",
      "filing_route": "domestic",
      "publication_date": "2026-05-01",
      "window_opens": "2026-05-02",
      "window_closes": "2026-08-03",
      "status": "open",
      "days_until_open": null,
      "days_remaining": 29,
      "office_time_zone": "Europe/Madrid",
      "trigger_event": "application_publication",
      "rule_version": "2026-05-06",
      "common_extension": null,
      "source": {
        "citation": "Article 46(1) EUTMR (Regulation (EU) 2017/1001)",
        "url": "https://eur-lex.europa.eu/eli/reg/2017/1001/oj/eng"
      }
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_bT9kM3nP"
}

Code Examples

curl "https://api.signa.so/v1/oppositions/compute" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "office": "euipo",
        "publication_date": "2026-05-01"
      }
    ],
    "as_of_date": "2026-07-05"
  }'

Errors

Status	Type	Description
400	`validation_error`	Malformed body, missing `items`, invalid date format, invalid enum value, or unknown body field
401	`unauthorized`	Missing or invalid API key
403	`forbidden`	API key missing the `trademarks:read` scope
422	`batch_too_large`	More than 1,000 items. The error carries `item_count` and `item_count_limit`
429	`rate_limited`	Too many requests

List Opposition Rules — inspect the office rule corpus and statutory citations
List Proceedings — actual filed opposition, cancellation, and appeal cases
Trademark Proceedings — proceedings scoped to one mark

List Opposition Rules List Classifications

​Overview

​Request Body

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Request Body

Response

Code Examples

Errors

Related Endpoints