USPTO TSDR API Guide

TSDR API Document Retrieval: Office Actions, PDF & Original Files

A practical guide to understanding and retrieving public trademark prosecution documents through the USPTO TSDR API.

Source-verifiableCustom qualificationStructured delivery
Data company workflowNormalize / qualify / verify / deliver
Published by Trademark-Leads.com Data Research TeamReviewed by Trademark-Leads.com Data Research TeamUpdated Sources last checked Scope U.S. federal trademark information and data
Direct answer

What documents can TSDR retrieve?

TSDR is the USPTO's record-level source for publicly available documents associated with trademark cases. Depending on the file history, users may see initial applications, Office Actions, applicant responses, notices, declarations, certificates and other prosecution materials.

A document is not guaranteed to exist for every record or event. The USPTO cautions that new submissions may take time to appear in TSDR after filing. For operational research, distinguish a document that has not yet been indexed from a document that does not exist.

Document types and research value

Non-final Office Actions

Examine the particular examiner requirements or refusals rather than guessing from a status label.

Final Office Actions

Confirm the official communication, issue categories and mailing date; finality should not be inferred only from a generic event label.

Responses and amendments

Review whether the applicant has answered an Office Action or updated the record.

Notices and decisions

Identify official case communications relevant to registration, abandonment, suspension or other stages.

Application and specimen records

Inspect available initial records and submitted examples where public and supported.

Registration and maintenance records

Review available certificates, maintenance submissions and communications associated with registrations.

Document retrieval workflow

1

Find the case record

Use a serial or registration number to open the relevant public TSDR record.

2

Inspect the document list

Review description, document type, date and available file identifiers; verify that the document belongs to the correct case.

3

Select the correct representation

Choose rendered PDF for convenient reading or original source content when available and appropriate.

4

Download within published limits

Queue document requests independently from lighter case-status calls so PDFs and ZIPs obey their separate cap.

5

Validate the file

Check content type, byte size and whether the downloaded file opens; don't treat an HTML error page as a PDF.

6

Preserve source context

Keep the case number, document description, official date, retrieval timestamp and source URL alongside any derived analysis.

When a document is missing from today's TSDR record

1

Check the case identifier

Verify the exact trademark serial/registration number and the current status in TSDR.

2

Review the Documents tab

Check whether a filing or Office Action is listed and when it was entered; a newly filed item may not be visible immediately.

3

Confirm document versus event

A prosecution-history event or case-status line does not automatically mean a downloadable examiner document is already available.

4

Try a supported format

Use the documented PDF or original-source download only for entries present and authorized; observe separate download limits.

5

Keep a provenance record

Retain document label, date, case ID, retrieval timestamp and whether the file was absent, delayed or actually downloaded.

Direct answer

PDF downloads versus original-source files

TSDR can provide rendered PDFs and original content packages, including ZIP formats where supported. A PDF is usually convenient for reading and sharing; original content may preserve an underlying filing representation that is more suitable for review or extraction. The official TSDR FAQ explains how users of the public interface can download either a PDF or original file when available.

For automation, use the API's documented download operations instead of assuming that a webpage link can be reused unchanged. Preserve the original file type, avoid renaming every download with the same filename and do not discard the source document identifier after parsing.

Separate rate limits apply to files

The USPTO FAQ states that ordinary API requests are limited to 60 per key per minute, while PDF and ZIP downloads—including multi-case downloads—are limited to 4 per key per minute. These limits are not a suggestion to distribute requests among additional credentials to bypass restrictions; design a compliant queue and honor the official documentation.

The USPTO FAQ states that ordinary API requests are limited to 60 per key per minute, while PDF and ZIP downloads—including multi-case downloads—are limited to 4 per key per minute. These limits are not a suggestion to distribute requests among additional credentials to bypass restrictions; design a compliant queue and honor the official documentation.

Direct answer

What can go wrong?

A missing PDF does not automatically mean the case has no Office Action. Check whether the document list actually contains the relevant entry and whether the file is still processing. An image of a mark is not the same thing as an Office Action attachment, and a case-status summary is not the same thing as an underlying examiner's document.

If a public document appears incorrectly classified or dated, the USPTO TSDR FAQ provides a path for reporting indexing problems. When researching sales prospects, do not interpret document availability as permission to misstate the applicant's present legal position or contact details.

Document retrieval questions

Can I retrieve documents by serial number?

Use a supported case identifier to discover the record's available documents; file-specific downloads may require a document identifier.

Do all cases contain Office Actions?

No. The document history depends on the application or registration and its prosecution events.

Why is a document missing immediately after filing?

USPTO notes that new documents may not appear in TSDR on the same day they are submitted.

What if a PDF is unreadable?

The USPTO FAQ recommends checking original-source content where available.

Are PDFs rate-limited differently?

Yes. The currently published PDF/ZIP limit is lower than the general API request limit.

Need TSDR API key access?

If you plan to retrieve public trademark case status, documents or images, review our $20-per-key offering and submit a request with your intended use. Access remains subject to USPTO service availability and usage requirements.

Buy TSDR API Key — $20