US Assignments#

Original API URL: https://assignment-api.uspto.gov/documentation-patent

Warning

The SSL configuration on the Assignments API is broken. SSL verification has therefore been turned off for the Assignment object. This means that the client is potentially vulnerable to man-in-the-middle attacks. When the SSL configuration is fixed, an update will be pushed, and this warning removed

Warning

Some publicly available assignments are not available through this interface. Due to a PTO technical issue, assignments of provisional applications are not made available when child applications are published through this interface. They can only be viewed by looking up the provisional application on Patent Center.

Note

The USPTO’s API is quite slow, so expect some lag time the first time records are retreived. Caching speeds up subsequent requests

Patent Client provides an interface to the USPTO’s patent assignment database. You can use it like this:

>>> from patent_client import Assignment
>>> assignments = Assignment.objects.filter(patent_number='9534285')
>>> len(assignments) >= 1
True
>>> assignments.first().id 
'60613-72'
>>> assignments.first().assignors[0].name 
'ENTEGRIS, INC.'
>>> assignments.first().assignees[0].name 
'TRUIST BANK, AS NOTES COLLATERAL AGENT'

>>> assignments = Assignment.objects.filter(assignee='Google') 
>>> len(assignments) > 200 
True

Models#

patent_client.uspto.assignment.model.parse_datetime(string)[source]#

patent_client.uspto.assignment.model.parse_date(string)[source]#

class patent_client.uspto.assignment.model.AbstractAssignmentModel[source]#

class patent_client.uspto.assignment.model.Assignor(*, patAssignorName: str, patAssignorExDate: Optional[date], patAssignorDateAck: Optional[date])[source]#

name: str#

execution_date: Optional[date]#

acknowledgement_date: Optional[date]#

class patent_client.uspto.assignment.model.Assignee(*, patAssigneeName: str, patAssigneeAddress: str)[source]#

name: str#

address: str#

class patent_client.uspto.assignment.model.Property(*, inventionTitle: str, inventionTitleLang: str, applNum: str, filingDate: Optional[Optional[date]] = None, intlPublDate: Optional[Optional[date]] = None, intlRegNum: Optional[str] = None, inventors: Optional[str] = None, issueDate: Optional[Optional[date]] = None, patNum: Optional[str] = None, pctNum: Optional[str] = None, publDate: Optional[Optional[date]] = None, publNum: Optional[str] = None)[source]#

invention_title: str#

invention_title_lang: str#

appl_num: str#

filing_date: Optional[Optional[date]]#

intl_publ_date: Optional[Optional[date]]#

intl_reg_num: Optional[str]#

inventors: Optional[str]#

issue_date: Optional[Optional[date]]#

pat_num: Optional[str]#

pct_num: Optional[str]#

publ_date: Optional[Optional[date]]#

publ_num: Optional[str]#

property application: Optional[USApplication]#: The related US Application

property patent: Patent#: The related US Patent, if any

property publication: PublishedApplication#: The related US Publication, if any

class patent_client.uspto.assignment.model.Correspondent(*, name: str, address: str)[source]#

name: str#

address: str#

class patent_client.uspto.assignment.model.Assignment(*, id: str, dateProduced: Optional[date] = None, actionKeyCode: Optional[str] = None, transactionDate: Optional[Optional[date]] = None, lastUpdateDate: Optional[date], purgeIndicator: bool, recordedDate: Optional[date], pageCount: int, conveyanceText: str, assignmentRecordHasImages: bool, attorneyDockNum: Optional[str] = None, patAssignorEarliestExDate: Optional[date], correspondent: Correspondent, assignors: List[Assignor], assignees: List[Assignee], properties: List[Property])[source]#

id: str#

date_produced: Optional[date]#

action_key_code: Optional[str]#

transaction_date: Optional[Optional[date]]#

last_update_date: Optional[date]#

purge_indicator: bool#

recorded_date: Optional[date]#

page_count: int#

conveyance_text: str#

assignment_record_has_images: bool#

attorney_dock_num: Optional[str]#

pat_assignor_earliest_ex_date: Optional[date]#

correspondent: Correspondent#

assignors: List[Assignor]#

assignees: List[Assignee]#

properties: List[Property]#

classmethod remove_see_document(v) → str[source]#

property reel_frame#

property image_url#

download(path: Optional[Union[str, Path]] = None)[source]#: downloads the PDF associated with the assignment to the current working directory

async adownload(path: Optional[Union[str, Path]] = None)[source]#: asynchronously downloads the PDF associated with the assignment to the current working directory

class patent_client.uspto.assignment.model.AssignmentPage(*, numFound: int, docs: list[patent_client.uspto.assignment.model.Assignment])[source]#

num_found: int#

docs: list[patent_client.uspto.assignment.model.Assignment]#