USPTO · Schema

USPTO Patent Application

A U.S. patent application as returned by the USPTO Open Data Portal Patent File Wrapper API.

PatentsTrademarksIntellectual PropertyGovernmentFederalOpen DataPTABTSDR

Properties

Name Type Description
applicationNumberText string USPTO application number (e.g. 16/123,456).
patentNumber string Granted patent number, if any.
filingDate string
grantDate string
publicationDate string
publicationNumber string
applicationTypeCategory string
applicationStatusCode string
applicationStatusDescriptionText string
applicationStatusDate string
inventionTitle string
firstInventorToFileIndicator string
examinerNameText string
groupArtUnitNumber string
classSubclass string
cpcClassificationBag array
applicantBag array
inventorBag array
assignmentBag array
View JSON Schema on GitHub

JSON Schema

uspto-patent-application-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/uspto-gov/main/json-schema/uspto-patent-application-schema.json",
  "title": "USPTO Patent Application",
  "description": "A U.S. patent application as returned by the USPTO Open Data Portal Patent File Wrapper API.",
  "type": "object",
  "required": ["applicationNumberText"],
  "properties": {
    "applicationNumberText": {"type": "string", "description": "USPTO application number (e.g. 16/123,456)."},
    "patentNumber": {"type": "string", "description": "Granted patent number, if any."},
    "filingDate": {"type": "string", "format": "date"},
    "grantDate": {"type": "string", "format": "date"},
    "publicationDate": {"type": "string", "format": "date"},
    "publicationNumber": {"type": "string"},
    "applicationTypeCategory": {"type": "string", "enum": ["UTILITY", "DESIGN", "PLANT", "REISSUE", "PROVISIONAL", "SIR"]},
    "applicationStatusCode": {"type": "string"},
    "applicationStatusDescriptionText": {"type": "string"},
    "applicationStatusDate": {"type": "string", "format": "date"},
    "inventionTitle": {"type": "string"},
    "firstInventorToFileIndicator": {"type": "string", "enum": ["Y", "N"]},
    "examinerNameText": {"type": "string"},
    "groupArtUnitNumber": {"type": "string"},
    "classSubclass": {"type": "string"},
    "cpcClassificationBag": {"type": "array", "items": {"type": "string"}},
    "applicantBag": {"type": "array", "items": {"$ref": "#/$defs/Party"}},
    "inventorBag": {"type": "array", "items": {"$ref": "#/$defs/Party"}},
    "assignmentBag": {"type": "array", "items": {"$ref": "#/$defs/Assignment"}}
  },
  "$defs": {
    "Party": {
      "type": "object",
      "properties": {
        "firstName": {"type": "string"},
        "lastName": {"type": "string"},
        "nameLineOneText": {"type": "string"},
        "country": {"type": "string"},
        "cityName": {"type": "string"},
        "geographicRegionName": {"type": "string"}
      }
    },
    "Assignment": {
      "type": "object",
      "properties": {
        "reelNumber": {"type": "string"},
        "frameNumber": {"type": "string"},
        "recordedDate": {"type": "string", "format": "date"},
        "executionDate": {"type": "string", "format": "date"},
        "conveyanceText": {"type": "string"},
        "assignorBag": {"type": "array", "items": {"$ref": "#/$defs/Party"}},
        "assigneeBag": {"type": "array", "items": {"$ref": "#/$defs/Party"}}
      }
    }
  }
}