> ## 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.
# Compute Deadlines
> Compute trademark maintenance deadlines without persisting data
## Overview
Compute maintenance deadlines for any set of trademarks (renewal windows, declarations of use, grace periods, and what happens if each is missed) without storing anything in Signa.
Send the facts you already have: jurisdiction, filing and registration dates, status. Signa returns the exact dated obligations, computed from the same rules that power its trademark data. A missed renewal can cost a registration, and this is the deadline logic you'd otherwise build and maintain office by office, kept current behind a single request.
Pair it with [List Deadline Rules](/api-reference/reference/deadline-rules) to inspect the underlying rules, renewal cycles, and statutory citations behind each computation.
## Request Body
Marks to compute, max 1,000 items. Results are returned in the same order, with one `deadline_computation` per input item.
Deadline jurisdiction code, e.g. `US`, `EU`, or `WIPO`. Values are normalized to uppercase.
Filing route. One of `national`, `regional`, or `madrid`. Defaults to `national`.
Trademark status. Defaults to `registered`. Accepted values are `filed`, `examining`, `pending_publication`, `published`, `opposition_period`, `pending_opposition`, `pending_cancellation`, `pending_issuance`, `registered`, `allowed`, `abandoned`, `withdrawn`, `surrendered`, `refused`, `cancelled`, `invalidated`, `expired`, or `unknown`.
Filing date as `YYYY-MM-DD`.
Registration date as `YYYY-MM-DD`.
Grant date as `YYYY-MM-DD`.
Current expiry date as `YYYY-MM-DD`.
Known renewal due date as `YYYY-MM-DD`.
Madrid designation date as `YYYY-MM-DD`.
Protection grant date as `YYYY-MM-DD`.
Madrid international registration date as `YYYY-MM-DD`.
Calendar date to compute relative to, as `YYYY-MM-DD`. Defaults to today.
How many years ahead to include. Minimum `1`, maximum `15`, default `5`.
Include optional deadlines such as US Section 15 incontestability. Defaults to `true`.
Include deadlines already past their grace period. Defaults to `false`.
## Response
A standard list response with `data: DeadlineComputation[]`. Pagination is not used; `data[i]` corresponds to `items[i]`.
Always `list`.
Always `deadline_computation`.
Jurisdiction used for the computation.
One of `national`, `regional`, or `madrid`.
`true` when Signa has a deadline configuration for the jurisdiction.
`unsupported_jurisdiction` when no rule configuration exists, otherwise `null`.
Deadline type code, e.g. `declaration_of_use` or `renewal`.
Human-readable deadline name.
Jurisdiction for this deadline.
Date used as the computation trigger.
Input field used as the trigger, e.g. `registration_date`.
First filing date for the deadline window.
Statutory due date.
End of the grace period after the due date.
Deadline status: `future`, `window_open`, `due_soon`, `in_grace`, or `missed`.
Calendar days from `as_of_date` to `due_date`.
Calendar days from `as_of_date` to `grace_expiry`.
Urgency bucket: `critical`, `upcoming`, `routine`, `overdue`, `in_grace`, or `missed`.
Outcome if the deadline plus grace is missed, e.g. `cancellation` or `expiration`.
Whether the deadline repeats in later cycles.
Whether the filing is optional.
Always `false`.
Always `{ "cursor": null }`.
Unique request identifier for support and debugging.
Unsupported jurisdictions return `supported: false` with an empty `deadlines` array. Dead statuses such as `cancelled`, `expired`, or `abandoned` return `supported: true` with an empty `deadlines` array when the jurisdiction is supported.
```json theme={null}
{
"object": "list",
"data": [
{
"object": "deadline_computation",
"jurisdiction_code": "US",
"filing_route": "national",
"supported": true,
"unsupported_reason": null,
"deadlines": [
{
"type": "declaration_of_use",
"name": "Section 8 Declaration of Use",
"jurisdiction_code": "US",
"trigger_date": "2020-03-10",
"trigger_field": "registration_date",
"window_opens": "2025-03-10",
"due_date": "2026-03-10",
"grace_expiry": "2026-09-10",
"status": "window_open",
"days_until_due": 248,
"days_until_grace_expiry": 432,
"urgency": "routine",
"consequence_if_missed": "cancellation",
"recurring": false,
"optional": false
}
]
}
],
"has_more": false,
"pagination": { "cursor": null },
"request_id": "req_bT9kM3nP"
}
```
## Code Examples
```bash cURL theme={null}
curl "https://api.signa.so/v1/deadlines/compute" \
-H "Authorization: Bearer sig_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"jurisdiction": "US",
"filing_date": "2019-01-15",
"registration_date": "2020-03-10"
}
],
"as_of_date": "2025-07-05"
}'
```
```typescript TypeScript theme={null}
import { Signa } from "@signa-so/sdk";
const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });
const results = await signa.deadlines.compute({
items: [{ jurisdiction: 'US', filing_date: '2019-01-15', registration_date: '2020-03-10' }]
});
for (const computation of results.data) {
console.log(computation.jurisdiction_code, computation.deadlines.length);
}
```
## Errors
| Status | Type | Description |
| ------ | ------------------ | ------------------------------------------------------------------------------------------------------------ |
| 400 | `validation_error` | Malformed body, missing `items`, invalid date format, invalid enum value, or `horizon_years` outside `1..15` |
| 401 | `unauthorized` | Missing or invalid API key |
| 403 | `forbidden` | API key missing the `trademarks:read` scope |
| 422 | `batch_too_large` | More than 1,000 items. The error carries `item_count` and `item_count_limit` |
| 429 | `rate_limited` | Too many requests |
## Related Endpoints
* [List Deadline Rules](/api-reference/reference/deadline-rules), inspect the rule corpus and statutory citations
* [List Jurisdictions](/api-reference/reference/list-jurisdictions), jurisdiction overview