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

import requests

url = "https://api.signa.so/v1/deadline-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/deadline-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/deadline-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/deadline-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/deadline-rules")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/deadline-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": "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": "domestic",
      "renewal_period_years": 10,
      "sources": [
        {
          "citation": "USPTO — Keeping Your Registration Alive",
          "url": "https://www.uspto.gov/trademarks/maintain/keeping-your-registration-alive"
        }
      ]
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null }
}

Overview

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

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

Two related vocabularies appear on this endpoint, and they are distinct:

• Filing routes (the filing_route query parameter): national, regional, madrid. This is how a mark was filed.
• Rule scope tags (the applies_to response field): domestic, madrid_only, all, or null. This is which filings a rule covers. domestic covers the national and regional routes, madrid_only covers the madrid route, and all or null covers every route.

Query Parameters

jurisdiction · string

Filter by jurisdiction code (uppercase ISO-2 plus 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.

A rule passes the filter when its applies_to scope covers the requested route: domestic rules pass for national or regional, madrid_only rules pass for madrid, and all or null rules pass for any value. Multiple values union the matching sets.

Response

A standard list response with data: DeadlineRule[]. Pagination is not used: 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 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 the window opens by months instead)

earliest_filing_months_before · integer | null

Months before the due date when the filing window opens (null if the 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 plus 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

Rule scope tag: domestic (national and regional routes), madrid_only (madrid route), all or null (every route)

renewal_period_years · integer

Renewal cycle length for the parent jurisdiction

sources · object[]

Show RuleSource

citation · string

Statutory or office citation

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": "domestic",
      "renewal_period_years": 10,
      "sources": [
        {
          "citation": "USPTO — Keeping Your Registration Alive",
          "url": "https://www.uspto.gov/trademarks/maintain/keeping-your-registration-alive"
        }
      ]
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null }
}

Code Examples

cURL

curl "https://api.signa.so/v1/deadline-rules?jurisdiction=US" \
  -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.deadlineRules({ jurisdiction: "US" });
for (const rule of rules.data) {
  console.log(rule.name, rule.due_year, rule.consequence_if_missed);
}

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

• Compute Deadlines, compute per-mark maintenance deadlines from these rules
• List Opposition Rules, opposition window rules
• List Jurisdictions, jurisdiction overview