List Deadline Rules

List all maintenance deadline rules across modeled jurisdictions

GET /v1/deadline-rules

List Deadline Rules

cURL

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

{
  "object": "list",
  "data": [
    {
      "object": "deadline_rule",
      "jurisdiction_code": "US",
      "name": "Section 8 Declaration of Use",
      "type": "declaration_of_use",
      "trigger": "registration_date",
      "due_year": 6,
      "earliest_filing_year": 5,
      "earliest_filing_months_before": null,
      "grace_period_months": 6,
      "consequence_if_missed": "cancellation",
      "recurring": false,
      "recurring_interval_years": null,
      "optional": false,
      "applies_to": null,
      "renewal_period_years": 10,
      "sources": [
        {
          "citation": "15 U.S.C. § 1058",
          "url": "https://www.law.cornell.edu/uscode/text/15/1058"
        }
      ]
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null }
}

Overview

Returns a flat list of maintenance deadline rules (renewal cycles, declarations of use, incontestability filings, etc.) across every modeled jurisdiction. Each rule is self-contained — it carries its parent jurisdiction’s renewal_period_years and statutory sources denormalized onto it, so you do not need a separate parent fetch to render a rule.

This endpoint exposes the same rule corpus that powers the deadlines block on a trademark detail response. Use it to build educational UI, validate deadline computations client-side, or expose statutory citations alongside an alert.

Query Parameters

jurisdiction · string

Filter by jurisdiction code (uppercase ISO-2 + WIPO). Comma-separated for multiple values, e.g. ?jurisdiction=US,EU,GB.

filing_route · string

Filter by filing route. Accepted values: national, regional, madrid. Comma-separated for multiple values.

Most rules have applies_to: null (apply to every route) and are returned for any value of filing_route. Rules tagged domestic only pass national / regional filters; rules tagged madrid_only only pass madrid; rules tagged all always pass.

Response

A standard list response with data: DeadlineRule[]. Pagination is not used — the corpus is small (~22 rules today) and is returned in a single page.

object · string

Always list

data · object[]

Show DeadlineRule

object · string

Always deadline_rule

jurisdiction_code · string

Jurisdiction this rule belongs to (uppercase ISO-2 or WIPO)

name · string

Human-readable rule name

type · string

Deadline type code: renewal, declaration_of_use, combined_renewal_and_use, declaration_of_incontestability, restoration, or international_renewal

trigger · string

Date field this rule is computed from: registration_date, filing_date, grant_date, protection_grant_date, or intl_registration_date

due_year · integer

Years from trigger date when the deadline falls

earliest_filing_year · integer | null

Year when the filing window opens (null if filing window opens by months instead)

earliest_filing_months_before · integer | null

Months before the due date when the filing window opens (null if window opens by years)

grace_period_months · integer

Grace period after the due date (may incur late fees)

consequence_if_missed · string

What happens if the deadline + grace passes (e.g. cancellation, expiration, expungement)

recurring · boolean

Whether this deadline repeats on each renewal cycle

recurring_interval_years · integer | null

Years between recurrences (null if not recurring)

optional · boolean

Whether filing is optional (e.g. US Section 15 incontestability)

applies_to · string | null

Constraint on which marks this rule applies to. null = applies to all routes; domestic / madrid_only / all for explicit scoping

renewal_period_years · integer

Renewal cycle length for the parent jurisdiction (denormalized for convenience)

sources · object[]

Show RuleSource

citation · string

Statutory citation, e.g. 15 U.S.C. § 1058

url · string

Authoritative URL for the citation

has_more · boolean

Always false — no pagination

pagination · object

Standard pagination envelope (cursor: null)

{
  "object": "list",
  "data": [
    {
      "object": "deadline_rule",
      "jurisdiction_code": "US",
      "name": "Section 8 Declaration of Use",
      "type": "declaration_of_use",
      "trigger": "registration_date",
      "due_year": 6,
      "earliest_filing_year": 5,
      "earliest_filing_months_before": null,
      "grace_period_months": 6,
      "consequence_if_missed": "cancellation",
      "recurring": false,
      "recurring_interval_years": null,
      "optional": false,
      "applies_to": null,
      "renewal_period_years": 10,
      "sources": [
        {
          "citation": "15 U.S.C. § 1058",
          "url": "https://www.law.cornell.edu/uscode/text/15/1058"
        }
      ]
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null }
}

Code Examples

cURL

curl "https://api.signa.so/v1/deadline-rules?jurisdiction=US" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx"

Errors

Status	Type	Description
400	validation_error	Invalid filing_route 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 Opposition Rules — opposition window rules
• List Jurisdictions — jurisdiction overview