Skip to main content
GET
List Portfolio Deadlines
See portfolio limits and references for current caps and external_ref semantics.

Overview

Computes deadlines on demand and returns a collection with data, has_more, and pagination.cursor. Each row identifies its trademark_id and statutory rule_id, with the deadline type, due date, and jurisdiction. For a calendar file, use Download Portfolio Calendar.

Query Parameters

Use due_before to bound the due date (default: approximately 24 months from now), type to filter a deadline type, and limit (default 20, maximum 100) plus the returned opaque cursor to page through results. due_before must be an ISO 8601 calendar date, YYYY-MM-DD (for example 2027-06-30). Anything else — a bare year, a datetime, free text — is rejected with 400 validation_error.

Errors

A due_before that is not YYYY-MM-DD returns 400 validation_error. More than 5,000 marks in this portfolio returns 422 portfolio_too_large. Split it into smaller portfolios and request each separately. A narrower date or type filter does not avoid this cap, and the ICS download has the same cap.