Check a trademark application's prosecution status and retrieve its document list via the USPTO TSDR API
domain: uspto.gov · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Register at account.uspto.gov and generate a TSDR API key, which is separate from any credentials used for other USPTO Open Data Portal APIs
Send requests to the dedicated TSDR API host rather than the general USPTO developer/Open Data Portal domain
Query case status by serial number, registration number, or international registration number to retrieve the current prosecution status
Retrieve the document list for the case to see all filed documents along with their document codes and filing dates
Download individual documents as PDF, or the full case file as a ZIP, using the corresponding endpoint and your API key
Monitor rate-limit response headers and pace bulk requests accordingly, especially for document downloads
Known gotchas
TSDR API rate limits are tight: roughly 60 requests per minute per key for status/data calls, but only about 4 requests per minute for PDF and ZIP document downloads — bulk downloads need explicit pacing
USPTO's older 'Open Data Portal Beta' (developer.uspto.gov) used for several other USPTO APIs was retired in 2026 in favor of the new Open Data Portal, but TSDR itself runs on its own separate API host and key — don't assume TSDR access details moved along with the other APIs
An API key has been mandatory for programmatic/bulk TSDR downloads since October 2020; scraping the public TSDR web UI is not a supported substitute for the API
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?