Skip to content

PTAB Trials - Documents Endpoints

Overview

The PTAB Trials Documents endpoints provide access to Patent Trial and Appeal Board (PTAB) trial documents. These endpoints allow you to search for documents, download results, retrieve specific documents, and get all documents for a trial.

All endpoints in this category begin with /api/v1/patent/trials/documents.

Available Endpoints

Endpoint Methods Description Documentation
/search GET, POST Search for trial documents using query parameters or JSON payload Search
/search/download GET, POST Download search results as a file Search/Download
/{documentIdentifier} GET Get a specific trial document Get Document
/{trialNumber}/documents GET Get all documents for a specific trial Get Documents by Trial

Quick Start

import asyncio
from uspto_odp.controller.uspto_odp_client import USPTOClient

async def main():
    client = USPTOClient(api_key="your-api-key-here")

    # Search for trial documents
    results = await client.search_trial_documents_get(
        q="trialNumber:IPR2020-00001"
    )

    # Get specific document
    document = await client.get_trial_document("document-id")

    # Get all documents for a trial
    documents = await client.get_trial_documents_by_trial("IPR2020-00001")

    await client.session.close()

asyncio.run(main())

Common Use Cases

Searching Trial Documents

Use the Search endpoint to find documents by: - Trial number - Document identifier - Document type - Filing date - Patent number - And other criteria

Downloading Results

Use the Search/Download endpoint to: - Download large result sets as files - Export search results for analysis

Retrieving Documents