Skip to main content
GET
/
v1
/
deadline-rules
List Deadline Rules
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 }
}

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.

​
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[]
​
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 "https://api.signa.so/v1/deadline-rules?jurisdiction=US" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorInvalid filing_route value
401unauthorizedMissing or invalid API key
403forbiddenAPI key missing the trademarks:read scope
429rate_limitedToo many requests