Documentation Index
Fetch the complete documentation index at: https://docs.signa.so/llms.txt
Use this file to discover all available pages before exploring further.
Why this matters
Most monitoring tools alert you that a confusingly-similar mark exists.
Signa alerts you that one exists and tells you, for the matched
jurisdiction, exactly when the opposition window opens, when it closes,
and how long you have left. Across 24 jurisdictions. With statutory
citations.
This is the headline feature of monitoring v1. The deadline-rules engine
(packages/types/src/deadline-rules) carries 24 opposition rules from
the same registry that drives renewal deadlines. Every alert that
matches a published mark in a covered jurisdiction includes:
must_act_by — the latest moment to file an opposition.opposition_window_status — open, closing_soon, critical, or closed.
The four states
| State | Definition |
|---|
open | Window is open and the deadline is more than 14 days out. |
closing_soon | Less than 14 days remaining. |
critical | Less than 3 days remaining (or grace period). |
closed | Window has elapsed. |
published to a status that ends
the window early (e.g. abandonment), opposition_window_status flips
to closed on the next sync that observes the change.
Severity escalation
Alert severity is automatically escalated based on opposition state:
| Window status | Severity |
|---|
open | normal |
closing_soon | high |
critical | critical |
closed | (no change) |
severity=critical in your dashboard to surface windows that
need action this week.
Worked example — USPTO publication
A new mark gets published in the USPTO Trademark Official Gazette on
2026-04-15. In the US, the standard opposition window is 30 days
from publication.
| Date | Sync sees | opposition_window_status | Severity | must_act_by |
|---|
| 2026-04-15 | mark published | open | normal | 2026-05-15 |
| 2026-05-02 | nothing new | open | normal | 2026-05-15 |
| 2026-05-04 | nothing new | closing_soon | high | 2026-05-15 |
| 2026-05-13 | nothing new | critical | critical | 2026-05-15 |
| 2026-05-16 | window elapsed | closed | (last) | 2026-05-15 |
critical
the following week works without any extra plumbing on your side.
Coverage
24 jurisdictions are wired in for monitoring v1: US, EU, DE, GB, CH, FR,
BX, SE, WIPO, CA, AU, NO, DK, FI, IS, PL, TH, VN, PH, BR, MX, plus three
held back for v1.1 follow-up. The list is live in the
packages/types/src/deadline-rules/configs/ registry.
Filtering for opposition work
const open = await signa.alerts.list({
severity: 'critical',
event_type: 'trademark.created',
});
for await (const a of open) {
if (a.opposition_window_status === 'critical') {
notifyAttorney(a.trademark_id, a.must_act_by!);
}
}
What this replaces
CompuMark and similar incumbents charge per-watch monthly fees and surface
opposition windows as a manual workflow inside their dashboard. The Signa
API delivers the same data structurally: the alert IS the window
notification, with the deadline embedded.
