USPTO

USPTO Documents API

Retrieve patent application documents

GitHub OpenAPI

Operations 9

GET /api/v1/patent/applications/{applicationNumberText}/documents List Application Documents #
GET /api/v1/download/applications/{applicationNumberText}/{documentId}.pdf Download Application Document PDF #
GET /api/v1/ptab/documents/search Search Documents #
GET /api/v1/ptab/documents/{documentIdentifier} Get Document #
GET /api/v1/ptab/documents/{documentIdentifier}/download Download Document #
GET /ts/cd/casedocs/bundle.pdf Get Case Documents PDF Bundle #
GET /ts/cd/casedocs/bundle.zip Get Case Documents ZIP Bundle #
GET /ts/cd/casedocs/{sn}/{documentIdentifier}.pdf Get Single Case Document PDF #
GET /ts/cd/rgbimg/sn{serialNumber}/{imageType}.jpg Get Mark Image #

Documentation

📖
Documentation
https://data.uspto.gov/apis/patent-file-wrapper/search
📖
Documentation
https://data.uspto.gov/apis/patent-file-wrapper/application-data
📖
Documentation
https://data.uspto.gov/apis/patent-file-wrapper/documents
📖
Documentation
https://data.uspto.gov/apis/patent-file-wrapper/assignments
📖
Documentation
https://developer.uspto.gov/api-catalog/ptab-api-v3-data-odp
📖
Documentation
https://data.uspto.gov/apis/ptab-trials/search-documents
📖
Documentation
https://data.uspto.gov/apis/ptab-trials/search-decisions
📖
Documentation
https://developer.uspto.gov/api-catalog/tsdr-data-api
📖
Documentation
https://developer.uspto.gov/swagger/tsdr-api-v1
📖
Documentation
https://www.uspto.gov/sites/default/files/documents/tm-enterprise-api-user-guide-v2.pdf
📖
Documentation
https://developer.uspto.gov/api-catalog/uspto-enriched-citation-api-v3
📖
Documentation
https://developer.uspto.gov/api-catalog/uspto-office-action-citations-api
📖
Documentation
https://data.uspto.gov/apis/bulk-data/search
📖
Documentation
https://data.uspto.gov/apis/bulk-data/product
📖
Documentation
https://data.uspto.gov/patent-file-wrapper/bulkdata/entire
📖
Documentation
https://data.uspto.gov/documents/documents/BDSS-to-ODP-API-Mapping.pdf
📖
Documentation
https://developer.uspto.gov/api-catalog/patentsview
📖
Documentation
https://patentsview.org/apis/api-endpoints

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/uspto-gov/refs/heads/main/openapi/uspto-gov-documents-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/uspto-gov/refs/heads/main/json-schema/uspto-patent-application-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/uspto-gov/refs/heads/main/json-schema/uspto-trademark-case-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/uspto-gov/refs/heads/main/json-ld/uspto-gov-context.jsonld
🔗
Portal
https://tsdr.uspto.gov/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/uspto-gov-documents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

uspto-gov-documents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Uspto Gov Documents API
  version: '1.0'
  description: 'Operations tagged Documents across 3 of this provider''s published API definitions: uspto-patent-file-wrapper-openapi.yml, uspto-ptab-openapi.yml, uspto-tsdr-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.uspto.gov
  description: USPTO Open Data Portal
- url: https://tsdrapi.uspto.gov
  description: USPTO TSDR API
security:
- ApiKeyAuth: []
tags:
- name: Documents
  description: Retrieve patent application documents
paths:
  /api/v1/patent/applications/{applicationNumberText}/documents:
    get:
      tags:
      - Documents
      summary: List Application Documents
      operationId: listApplicationDocuments
      parameters:
      - name: applicationNumberText
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of documents in the file wrapper.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Document'
    servers:
    - url: https://api.uspto.gov
      description: USPTO Open Data Portal
  /api/v1/download/applications/{applicationNumberText}/{documentId}.pdf:
    get:
      tags:
      - Documents
      summary: Download Application Document PDF
      operationId: downloadApplicationDocumentPdf
      parameters:
      - name: applicationNumberText
        in: path
        required: true
        schema:
          type: string
      - name: documentId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: PDF binary.
          content:
            application/pdf:
              schema:
                type: string
                format: binary
    servers:
    - url: https://api.uspto.gov
      description: USPTO Open Data Portal
  /api/v1/ptab/documents/search:
    get:
      tags:
      - Documents
      summary: Search Documents
      operationId: searchPtabDocuments
      parameters:
      - name: proceedingNumber
        in: query
        schema:
          type: string
      - name: documentCategory
        in: query
        schema:
          type: string
      - name: filingDateFrom
        in: query
        schema:
          type: string
          format: date
      - name: filingDateTo
        in: query
        schema:
          type: string
          format: date
      - name: offset
        in: query
        schema:
          type: integer
      - name: limit
        in: query
        schema:
          type: integer
          default: 25
      responses:
        '200':
          description: Search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocumentSearchResponse'
    servers:
    - url: https://api.uspto.gov
      description: USPTO Open Data Portal
  /api/v1/ptab/documents/{documentIdentifier}:
    get:
      tags:
      - Documents
      summary: Get Document
      operationId: getPtabDocument
      parameters:
      - name: documentIdentifier
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Document metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Document_2'
    servers:
    - url: https://api.uspto.gov
      description: USPTO Open Data Portal
  /api/v1/ptab/documents/{documentIdentifier}/download:
    get:
      tags:
      - Documents
      summary: Download Document
      operationId: downloadPtabDocument
      parameters:
      - name: documentIdentifier
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: PDF binary
          content:
            application/pdf:
              schema:
                type: string
                format: binary
    servers:
    - url: https://api.uspto.gov
      description: USPTO Open Data Portal
  /ts/cd/casedocs/bundle.pdf:
    get:
      tags:
      - Documents
      summary: Get Case Documents PDF Bundle
      operationId: getCaseDocumentsPdfBundle
      parameters:
      - name: sn
        in: query
        schema:
          type: string
        description: Serial number
      - name: rn
        in: query
        schema:
          type: string
        description: Registration number
      - name: rf
        in: query
        schema:
          type: string
        description: Reference number
      - name: ir
        in: query
        schema:
          type: string
        description: International registration number
      responses:
        '200':
          description: PDF bundle
          content:
            application/pdf:
              schema:
                type: string
                format: binary
    servers:
    - url: https://tsdrapi.uspto.gov
      description: USPTO TSDR API
  /ts/cd/casedocs/bundle.zip:
    get:
      tags:
      - Documents
      summary: Get Case Documents ZIP Bundle
      operationId: getCaseDocumentsZipBundle
      parameters:
      - name: sn
        in: query
        schema:
          type: string
      - name: rn
        in: query
        schema:
          type: string
      - name: rf
        in: query
        schema:
          type: string
      - name: ir
        in: query
        schema:
          type: string
      responses:
        '200':
          description: ZIP bundle
          content:
            application/zip:
              schema:
                type: string
                format: binary
    servers:
    - url: https://tsdrapi.uspto.gov
      description: USPTO TSDR API
  /ts/cd/casedocs/{sn}/{documentIdentifier}.pdf:
    get:
      tags:
      - Documents
      summary: Get Single Case Document PDF
      operationId: getCaseDocumentPdf
      parameters:
      - name: sn
        in: path
        required: true
        schema:
          type: string
      - name: documentIdentifier
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: PDF binary
          content:
            application/pdf:
              schema:
                type: string
                format: binary
    servers:
    - url: https://tsdrapi.uspto.gov
      description: USPTO TSDR API
  /ts/cd/rgbimg/sn{serialNumber}/{imageType}.jpg:
    get:
      tags:
      - Documents
      summary: Get Mark Image
      operationId: getMarkImage
      parameters:
      - name: serialNumber
        in: path
        required: true
        schema:
          type: string
      - name: imageType
        in: path
        required: true
        schema:
          type: string
          enum:
          - drawing
          - specimen
      responses:
        '200':
          description: JPEG
          content:
            image/jpeg:
              schema:
                type: string
                format: binary
    servers:
    - url: https://tsdrapi.uspto.gov
      description: USPTO TSDR API
components:
  schemas:
    Document:
      type: object
      properties:
        documentIdentifier:
          type: string
        documentCode:
          type: string
        documentCodeDescriptionText:
          type: string
        officialDate:
          type: string
          format: date
        pageTotalQuantity:
          type: integer
        directionCategory:
          type: string
        downloadOptionBag:
          type: array
          items:
            type: object
            properties:
              mimeTypeIdentifier:
                type: string
              downloadUrl:
                type: string
                format: uri
    Document_2:
      type: object
      properties:
        documentIdentifier:
          type: string
        proceedingNumber:
          type: string
        documentTitleText:
          type: string
        documentCategory:
          type: string
        filingDate:
          type: string
          format: date
        filingPartyCategory:
          type: string
        pageQuantity:
          type: integer
        downloadUrl:
          type: string
          format: uri
    DocumentSearchResponse:
      type: object
      properties:
        count:
          type: integer
        results:
          type: array
          items:
            $ref: '#/components/schemas/Document_2'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
x-refined-from:
- uspto-patent-file-wrapper-openapi.yml
- uspto-ptab-openapi.yml
- uspto-tsdr-openapi.yml