Skip to main content
GET
/
v1
/
portfolios
/
{id}
/
deadlines
Portfolio Deadlines
curl --request GET \
  --url https://api.example.com/v1/portfolios/{id}/deadlines
{
  "object": "list",
  "data": [
    {
      "trademark_id": "tm_8kLm2nPq",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "deadline_type": "declaration_of_use",
      "deadline_label": "Section 8 Declaration of Use",
      "due_date": "2030-09-18",
      "window_opens": "2029-09-18",
      "grace_period_ends": "2031-03-18",
      "is_critical": true
    },
    {
      "trademark_id": "tm_Qr6nK9jL",
      "mark_text": "AURORA DIGITAL",
      "office_code": "euipo",
      "jurisdiction_code": "EU",
      "deadline_type": "renewal",
      "deadline_label": "EUTM Renewal",
      "due_date": "2033-07-20",
      "window_opens": "2033-01-20",
      "grace_period_ends": "2034-01-20",
      "is_critical": true
    },
    {
      "trademark_id": "tm_8kLm2nPq",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "deadline_type": "incontestability",
      "deadline_label": "Section 15 Incontestability",
      "due_date": "2029-09-18",
      "window_opens": "2029-09-18",
      "grace_period_ends": null,
      "is_critical": false
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_jC9tU5vW"
}

​
Overview

Returns computed upcoming deadlines for every trademark in a portfolio. Deadlines include renewal dates, declarations of use (US Section 8/15), proof-of-use requirements, and other jurisdiction-specific maintenance obligations. Results are sorted by deadline date ascending (soonest first). Use this to build renewal calendars, trigger reminder workflows, and audit portfolio maintenance health.

​
Path Parameters

​
id
string
required
Portfolio ID (e.g., ptf_abc123)

​
Query Parameters

​
limit
integer
default:"50"
Items per page (max 100)
​
cursor
string
Pagination cursor from previous response
​
due_before
string
Only include deadlines due before this ISO date (e.g., 2027-01-01)
​
due_after
string
Only include deadlines due after this ISO date
​
type
string
Filter by deadline type: renewal, declaration_of_use, proof_of_use, affidavit, incontestability

​
Response

​
data
object[]
{
  "object": "list",
  "data": [
    {
      "trademark_id": "tm_8kLm2nPq",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "deadline_type": "declaration_of_use",
      "deadline_label": "Section 8 Declaration of Use",
      "due_date": "2030-09-18",
      "window_opens": "2029-09-18",
      "grace_period_ends": "2031-03-18",
      "is_critical": true
    },
    {
      "trademark_id": "tm_Qr6nK9jL",
      "mark_text": "AURORA DIGITAL",
      "office_code": "euipo",
      "jurisdiction_code": "EU",
      "deadline_type": "renewal",
      "deadline_label": "EUTM Renewal",
      "due_date": "2033-07-20",
      "window_opens": "2033-01-20",
      "grace_period_ends": "2034-01-20",
      "is_critical": true
    },
    {
      "trademark_id": "tm_8kLm2nPq",
      "mark_text": "AURORA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "deadline_type": "incontestability",
      "deadline_label": "Section 15 Incontestability",
      "due_date": "2029-09-18",
      "window_opens": "2029-09-18",
      "grace_period_ends": null,
      "is_critical": false
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_jC9tU5vW"
}

​
Code Examples

curl "https://api.signa.so/v1/portfolios/ptf_abc123/deadlines?due_before=2027-01-01&type=renewal" \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
400validation_errorInvalid date format or deadline type
401unauthorizedMissing or invalid API key
404not_foundPortfolio ID does not exist
429rate_limitedToo many requests