USPTO Database

Overview

USPTO data for patents and trademarks: application and patent bibliographic search, examination (prosecution) history, continuity, assignments, office actions, PTAB proceedings, and trademark status (TSDR), for IP analysis and prior art searches. Most patent APIs now live on the USPTO Open Data Portal (ODP) at https://api.uspto.gov; several older services were retired in 2025–2026, so check the status table below before reusing older code.

When to Use This Skill

• Patent/application search: by title keywords, applicant, inventor, dates, status
• Examination history: transactions, office actions, allowance/abandonment, pendency
• Continuity and ownership: parent/child applications, recorded assignments
• Office actions: text, cited references, and rejection types (101/102/103/112)
• PTAB: IPR/PGR trials, appeal and interference decisions
• Trademarks: status, owner, goods/services, and prosecution history via TSDR
• Portfolio analysis: patents and marks of a company or inventor

Does NOT Trigger

USPTO API Status (verified 2026-09-23)

Consequences: there is currently no public API for full-text claims/abstract search with disambiguated assignees. Use ODP bibliographic search for discovery, ODP bulk grant/pgpub XML (or the PatentsView bulk tables on ODP) for full text, and say so when a user asks for PatentsView-style queries.

Quick Start

API Keys

• ODP key (Patent File Wrapper, office actions, PTAB, petitions, bulk data):

sign in at https://data.uspto.gov with a USPTO.gov account (required for ODP since 2026-06-18) and request a key under APIs → Getting Started. Send it as X-API-KEY. ODP deletes keys that stay unused for 90 days.

• TSDR key (trademarks): request the TSDR product at

https://account.uspto.gov/api-manager/ and send it as USPTO-API-KEY — an X-Api-Key header is ignored, so the call is treated as keyless (HTTP 401).

export USPTO_ODP_API_KEY="..."    # ODP scripts (USPTO_API_KEY is read as a fallback)
export USPTO_TSDR_API_KEY="..."   # trademark_client.py

Helper Scripts

• `scripts/patent_search.py` — ODP Patent File Wrapper search (title,

inventor, applicant, grant-date range, patent-number lookup)

• `scripts/peds_client.py` — ODP file-wrapper client, the PEDS successor

(FileWrapperClient, alias PEDSHelper): status summary, transactions, office-action events, prosecution statistics, continuity, assignments

• `scripts/trademark_client.py` — TSDR client for trademark status, owners,

goods/services, and prosecution history

The scripts were checked against the ODP OpenAPI spec and live endpoint routing (401/403 without a key); run them with your own key before relying on them.

Task 1: Searching Patents

POST a JSON body to https://api.uspto.gov/api/v1/patent/applications/search:

import os, requests

body = {
    "q": 'applicationMetaData.inventionTitle:"lidar"',
    "filters": [{"name": "applicationMetaData.applicationTypeLabelName", "value": ["Utility"]}],
    "rangeFilters": [{"field": "applicationMetaData.grantDate",
                      "valueFrom": "2024-01-01", "valueTo": "2024-12-31"}],
    "sort": [{"field": "applicationMetaData.grantDate", "order": "desc"}],
    "pagination": {"offset": 0, "limit": 25},
}
r = requests.post("https://api.uspto.gov/api/v1/patent/applications/search",
                  headers={"X-API-KEY": os.environ["USPTO_ODP_API_KEY"]}, json=body, timeout=60)
for rec in r.json().get("patentFileWrapperDataBag", []):
    meta = rec["applicationMetaData"]
    print(rec["applicationNumberText"], meta.get("patentNumber"), meta.get("inventionTitle"))

The query language is Solr-like (field:value, AND/OR/NOT, wildcards, quoted phrases). Useful applicationMetaData fields: inventionTitle, patentNumber, filingDate, grantDate, applicationStatusDescriptionText, firstApplicantName, firstInventorName, cpcClassificationBag, groupArtUnitNumber, examinerNameText. A search with no matches returns HTTP 404 ("No matching records found"), not an empty 200. The file wrapper holds bibliographic data only — not claims or abstracts.

references/patentsearch_api.md documents the offline PatentsView PatentSearch API (query operators, fields) for reading older code and for when USPTO restores it; references/usage_examples.md (Task 1) has worked code.

Task 2: Retrieving Patent Examination Data

GET https://api.uspto.gov/api/v1/patent/applications/{applicationNumberText}/transactions returns eventDataBag[] items of {eventCode, eventDescriptionText, eventDate}; /meta-data returns status, dates, examiner, and art unit. scripts/peds_client.py wraps these (get_status_summary, get_transaction_history, get_office_actions, analyze_prosecution, get_continuity, get_assignments).

Common transaction codes: CTNF (non-final rejection), CTFR (final rejection), NOA (notice of allowance), WRIT (response filed), ISS.FEE (issue fee), ABND (abandoned), AOPF (office action mailed). Application status codes (not event codes) are listed by GET /api/v1/patent/status-codes.

references/peds_api.md covers transaction codes and prosecution analysis; its PEDS/library sections are historical.

Task 3: Searching and Monitoring Trademarks

Using TSDR (Trademark Status & Document Retrieval)

GET https://tsdrapi.uspto.gov/ts/cd/casestatus/sn{serial}/info (or rn{registration}) returns the ST96 XML status record; casedocs/{caseid}/info lists the case documents, and .../content.pdf / download.zip fetch them (4 per minute). The scripts/trademark_client.py TrademarkClient looks up marks by serial or registration number, fetches status, runs check_trademark_health, and supports portfolio monitoring.

Common statuses: REGISTERED, PENDING, PUBLISHED FOR OPPOSITION, ABANDONED, CANCELLED, SUSPENDED, REGISTERED AND RENEWED.

See references/usage_examples.md (Task 3) for worked code and references/trademark_api.md for status codes, prosecution history, and ownership tracking.

Task 4: Tracking Assignments and Ownership

The Assignment Search API host (assignment-api.uspto.gov) is gone. For a given application, GET https://api.uspto.gov/api/v1/patent/applications/{app}/assignment returns assignmentBag[] with reelAndFrameNumber, conveyanceText, assignmentRecordedDate, assignorBag, and assigneeBag (scripts/peds_client.py --assignments {app}). For company-wide ownership questions use the assignment datasets in the ODP bulk-data catalog.

Common conveyance types: ASSIGNMENT OF ASSIGNORS INTEREST (ownership transfer), SECURITY AGREEMENT, MERGER, CHANGE OF NAME, ASSIGNMENT OF PARTIAL INTEREST.

Task 5: Office Actions, Citations, and PTAB

• Office actions (text retrieval, citations from PTO-892/1449, rejections by

statute 101/102/103/112/double patenting, and AI-extracted enriched citations) are served from the ODP host as form-encoded POSTs with a Lucene criteria string, e.g. criteria=patentApplicationNumber:12190351, start=0, rows=25, to https://api.uspto.gov/api/v1/patent/oa/oa_rejections/v2/records.

• PTAB proceedings (IPR, PGR, CBM), decisions, documents, and ex parte appeal

decisions have ODP search endpoints (table above).

• Litigation and Cancer Moonshot datasets were DSAPI services on the retired

developer.uspto.gov; look for them in the ODP bulk-data catalog.

references/additional_apis.md describes what each dataset contains and how to combine them.

Complete Analysis Example

For full patent intelligence: find the application through Patent File Wrapper search, pull /meta-data and /transactions for prosecution history, /continuity for the family, /assignment for ownership, then the office-action rejections API for the grounds of rejection. references/usage_examples.md (Complete Analysis Example) has a worked version.

Best Practices

1. Keys: keep ODP and TSDR keys in environment variables, never in code or

version control; they are different keys sent in different headers.

1. Rate limits: TSDR allows 60 requests/minute per key (4/minute for PDF/ZIP);

back off exponentially on HTTP 429 for every USPTO API.

1. Coverage: Patent File Wrapper holds applications filed from 2001-01-01;

use bulk data for older patents and for claims/description full text.

1. Data handling: many fields are absent for pending or older applications —

handle missing keys, and parse dates as YYYY-MM-DD strings.

1. Reproducibility: ODP is refreshed daily; record the query date with results.

Resources

• Open Data Portal: https://data.uspto.gov/ (APIs → Getting Started; interactive Swagger UI needs an ODP key)
• PatentsView → ODP transition guide: https://data.uspto.gov/support/transition-guide/patentsview
• PEDS → ODP transition guide (PEDS-to-ODP API mapping): https://data.uspto.gov/support/transition-guide/peds
• TSDR key manager: https://account.uspto.gov/api-manager/
• ODP support: [email protected]

Reference Files

• references/usage_examples.md - Worked Python examples per task
• references/patentsearch_api.md - PatentsView PatentSearch API (offline since 2026-03-20; historical)
• references/peds_api.md - Transaction codes and prosecution analysis (PEDS sections historical)
• references/trademark_api.md - TSDR trademark API
• references/additional_apis.md - Office actions, citations, PTAB, litigation datasets

Scripts

• scripts/patent_search.py - ODP Patent File Wrapper search client
• scripts/peds_client.py - ODP file-wrapper client (PEDS successor)
• scripts/trademark_client.py - TSDR trademark client