/api/v1/patent/

Upstream view PatentList (index patents, response key patents). Any field may be null where the bulk data has no value. Default fields (f): patent_id, patent_title, patent_date. Default sort (s): [{"patent_id": "asc"}]. Nested groups usable in q and f with dotted names: applicants, application, assignees, attorneys, botanic, cpc_at_issue, cpc_current, examiners, figures, foreign_priority, gov_interest_contract_award_numbers, gov_interest_organizations, granted_pregrant_crosswalk, inventors, ipcr, pct_data, us_related_documents, us_term_of_grant, uspc_at_issue, wipo. Default options (o): {"pad_patent_id": false, "exclude_withdrawn": true}.

Routes: GET POST /api/v1/patent/ GET POST /api/v1/patent/{pk}/
Response key: patents
Default f: patent_id, patent_title, patent_date
Default s: [{"patent_id": "asc"}]
Default o: {"pad_patent_id": false, "exclude_withdrawn": true}
q: required on the list route
Detail key: patent_id in the path; a "/" in a key is written ":"
Nested groups: applicants, application, assignees, attorneys, botanic, cpc_at_issue, cpc_current, examiners, figures, foreign_priority, gov_interest_contract_award_numbers, gov_interest_organizations, granted_pregrant_crosswalk, inventors, ipcr, pct_data, us_related_documents, us_term_of_grant, uspc_at_issue, wipo

Example

curl -s -G -H "X-Api-Key: $KEY" https://patentref.io/api/v1/patent/ \
  --data-urlencode 'q={"patent_id": "7861317"}'

import json, os, requests

base_url = "https://patentref.io"
headers = {"X-Api-Key": os.environ["PATENTREF_KEY"]}
params = {"q": {"patent_id": "7861317"}}
r = requests.get(base_url + "/api/v1/patent/", headers=headers,
                 params={k: json.dumps(v) for k, v in params.items()})
r.raise_for_status()
data = r.json()
print(data["total_hits"], data["patents"][:3])

More requests on this endpoint: ref_gte_date, ref_not, ref_value_array_nested, ref_and, ref_complex_1, ref_or_text_any, ref_nested_and_or_phrase, ref_sort_multi, ex1_id_list, ex2_date_range_post, ex3_text_all_abstract, ex5_cpc_section, ex6_pagination_page2, test_neq_list, test_begins_nested, test_contains_nested, test_text_all_title, test_text_phrase_title, test_keyword_exact_org, test_keyword_text_any_org, test_mix_text_non_text, nb_patent_year_with_inventors_group, patent_withdrawn_override, patent_pad_patent_id.

Fields

Kind is how q treats the field (grammar, Field kinds). Sortable fields go in s. Nested fields are named with a dot in q and f; naming the group returns its upstream fields, and a field whose note says it is present only when f names it comes back only then. The rows of a group come in the order of their source (grammar, the response and paging).

Field	Type	Kind	Sortable	Note
`patent_id`	string	keyword	yes
`patent_title`	string	text
`patent_type`	string	keyword	yes
`patent_country`	string	returned, not searchable
`patent_date`	string	date	yes
`patent_year`	number	number	yes
`patent_abstract`	string	text
`patent_cpc_current_group_average_patent_processing_days`	number	number	yes
`withdrawn`	boolean	boolean	yes
`patent_detail_desc_length`	number	number	yes
`patent_earliest_application_date`	string	date	yes
`patent_num_foreign_documents_cited`	number	number	yes
`patent_num_times_cited_by_us_patents`	number	number	yes
`patent_num_total_documents_cited`	number	number	yes
`patent_num_us_applications_cited`	number	number	yes
`patent_num_us_patents_cited`	number	number	yes
`patent_processing_days`	number	number	yes
`patent_term_extension`	number	number	yes
`gov_interest_statement`	string	text
`patent_uspc_current_mainclass_average_patent_processing_days`	number	number	yes
`wipo_kind`	string	keyword	yes
`application`	group (list of objects)			Nested group: name it in f ("application") for every field of the group, or "application.<field>" for one; query its fields in q with the same dotted names.
`application.application_id`	string	keyword
`application.application_type`	string	keyword
`application.filing_date`	string	date
`application.series_code`	string	keyword
`application.rule_47_flag`	boolean	boolean
`application.filing_type`	string	keyword
`applicants`	group (list of objects)			Nested group: name it in f ("applicants") for every field of the group, or "applicants.<field>" for one; query its fields in q with the same dotted names.
`applicants.applicant_name_first`	string	text with a keyword form
`applicants.applicant_name_last`	string	text with a keyword form
`applicants.applicant_organization`	string	text with a keyword form
`applicants.applicant_sequence`	integer	number
`applicants.applicant_designation`	string	keyword
`applicants.applicant_type`	string	keyword
`applicants.location_id`	string	keyword
`assignees`	group (list of objects)			Nested group: name it in f ("assignees") for every field of the group, or "assignees.<field>" for one; query its fields in q with the same dotted names.
`assignees.assignee`	string (URL)	returned, not searchable		Link to the detail record: https://patentref.io/api/v1/assignee/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: none: the index has no search field for it, so a query on it matches nothing, as upstream; query the id field of the group instead. It comes back beside that id: f naming the id field or the whole group returns both, and f naming this link alone returns nothing.
`assignees.assignee_id`	string	keyword
`assignees.assignee_type`	string	keyword
`assignees.assignee_individual_name_first`	string	text with a keyword form
`assignees.assignee_individual_name_last`	string	text with a keyword form
`assignees.assignee_organization`	string	text with a keyword form
`assignees.assignee_location_id`	string	keyword
`assignees.assignee_city`	string	text with a keyword form
`assignees.assignee_state`	string	text with a keyword form
`assignees.assignee_country`	string	text with a keyword form		An ISO 3166-1 alpha-2 country code in capitals, as PatentsView gives it: the United Kingdom is "GB", and "UK" matches nothing.
`assignees.assignee_sequence`	integer	number
`assignees.disambiguated`	boolean	boolean		PatentRef addition: false on rows of weekly grants that no PatentsView release covers yet (names as printed; the ids and what derives from them, such as the links, location ids and the inventor gender code, null); true on PatentsView rows. Present only when f names it (assignees.disambiguated), then on every row; a whole group carries the upstream fields only, so every row of a group has the same keys.
`assignees.raw_assignee_individual_name_first`	string	returned when f names it		PatentRef addition: the first name as printed on this patent's grant (PatentsView g_assignee_not_disambiguated, and the USPTO weekly grant full text for the weeks no PatentsView release covers yet), beside the disambiguated name, which is PatentsView's one label for a whole cluster of names. Present only when f names it (assignees.raw_assignee_individual_name_first), then on every row; null where the bulk data has none or the data in service predates it. A whole group carries the upstream fields only. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`assignees.raw_assignee_individual_name_last`	string	returned when f names it		PatentRef addition: the last name as printed on this patent's grant (PatentsView g_assignee_not_disambiguated, and the USPTO weekly grant full text for the weeks no PatentsView release covers yet), beside the disambiguated name, which is PatentsView's one label for a whole cluster of names. Present only when f names it (assignees.raw_assignee_individual_name_last), then on every row; null where the bulk data has none or the data in service predates it. A whole group carries the upstream fields only. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`assignees.raw_assignee_organization`	string	returned when f names it		PatentRef addition: the organization's name as printed on this patent's grant (PatentsView g_assignee_not_disambiguated, and the USPTO weekly grant full text for the weeks no PatentsView release covers yet), beside the disambiguated name, which is PatentsView's one label for a whole cluster of names. Present only when f names it (assignees.raw_assignee_organization), then on every row; null where the bulk data has none or the data in service predates it. A whole group carries the upstream fields only. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`attorneys`	group (list of objects)			Nested group: name it in f ("attorneys") for every field of the group, or "attorneys.<field>" for one; query its fields in q with the same dotted names.
`attorneys.attorney_id`	string	keyword
`attorneys.attorney_sequence`	integer	number
`attorneys.attorney_name_first`	string	text with a keyword form
`attorneys.attorney_name_last`	string	text with a keyword form
`attorneys.attorney_organization`	string	text with a keyword form
`attorneys.disambiguated`	boolean	boolean		PatentRef addition: false on rows of weekly grants that no PatentsView release covers yet (names as printed; the ids and what derives from them, such as the links, location ids and the inventor gender code, null); true on PatentsView rows. Present only when f names it (attorneys.disambiguated), then on every row; a whole group carries the upstream fields only, so every row of a group has the same keys.
`botanic`	group (list of objects)			Nested group: name it in f ("botanic") for every field of the group, or "botanic.<field>" for one; query its fields in q with the same dotted names.
`botanic.latin_name`	string	keyword
`botanic.variety`	string	keyword
`cpc_at_issue`	group (list of objects)			Nested group: name it in f ("cpc_at_issue") for every field of the group, or "cpc_at_issue.<field>" for one; query its fields in q with the same dotted names.
`cpc_at_issue.cpc_sequence`	number	number
`cpc_at_issue.cpc_section_id`	string	returned, not searchable
`cpc_at_issue.cpc_class`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/cpc_class/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`cpc_at_issue.cpc_class_id`	string	keyword
`cpc_at_issue.cpc_subclass`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/cpc_subclass/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`cpc_at_issue.cpc_subclass_id`	string	keyword
`cpc_at_issue.cpc_group`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/cpc_group/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`cpc_at_issue.cpc_group_id`	string	keyword
`cpc_at_issue.patent_number`	string	returned, not searchable
`cpc_current`	group (list of objects)			Nested group: name it in f ("cpc_current") for every field of the group, or "cpc_current.<field>" for one; query its fields in q with the same dotted names.
`cpc_current.cpc_sequence`	number	number
`cpc_current.cpc_section_id`	string	returned, not searchable
`cpc_current.cpc_class`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/cpc_class/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`cpc_current.cpc_class_id`	string	keyword
`cpc_current.cpc_subclass`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/cpc_subclass/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`cpc_current.cpc_subclass_id`	string	keyword
`cpc_current.cpc_group`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/cpc_group/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`cpc_current.cpc_group_id`	string	keyword
`cpc_current.patent_number`	string	returned, not searchable
`examiners`	group (list of objects)			Nested group: name it in f ("examiners") for every field of the group, or "examiners.<field>" for one; query its fields in q with the same dotted names.
`examiners.examiner_id`	string	keyword
`examiners.examiner_first_name`	string	text with a keyword form
`examiners.examiner_last_name`	string	text with a keyword form
`examiners.examiner_role`	string	keyword
`examiners.art_group`	string	keyword
`foreign_priority`	group (list of objects)			Nested group: name it in f ("foreign_priority") for every field of the group, or "foreign_priority.<field>" for one; query its fields in q with the same dotted names.
`foreign_priority.priority_claim_sequence`	integer	number
`foreign_priority.priority_claim_kind`	string	keyword
`foreign_priority.foreign_application_id`	string	keyword
`foreign_priority.filing_date`	string	date
`foreign_priority.foreign_country_filed`	string	keyword		The two-letter office code printed on the grant: mostly the WIPO codes (GB, EP for the European Patent Office, WO for international applications), with "UK" on some older rows.
`figures`	group (list of objects)			Nested group: name it in f ("figures") for every field of the group, or "figures.<field>" for one; query its fields in q with the same dotted names.
`figures.num_figures`	integer	number
`figures.num_sheets`	integer	number
`gov_interest_contract_award_numbers`	group (list of objects)			Nested group: name it in f ("gov_interest_contract_award_numbers") for every field of the group, or "gov_interest_contract_award_numbers.<field>" for one; query its fields in q with the same dotted names.
`gov_interest_contract_award_numbers.award_number`	string	keyword
`gov_interest_organizations`	group (list of objects)			Nested group: name it in f ("gov_interest_organizations") for every field of the group, or "gov_interest_organizations.<field>" for one; query its fields in q with the same dotted names.
`gov_interest_organizations.fedagency_name`	string	text with a keyword form
`gov_interest_organizations.level_one`	string	text with a keyword form
`gov_interest_organizations.level_two`	string	text with a keyword form
`gov_interest_organizations.level_three`	string	text with a keyword form
`granted_pregrant_crosswalk`	group (list of objects)			Nested group: name it in f ("granted_pregrant_crosswalk") for every field of the group, or "granted_pregrant_crosswalk.<field>" for one; query its fields in q with the same dotted names.
`granted_pregrant_crosswalk.patent_id`	string	returned, not searchable
`granted_pregrant_crosswalk.document_number`	string	keyword
`granted_pregrant_crosswalk.pgpubs_document_number`	string	returned, not searchable
`granted_pregrant_crosswalk.application_number`	string	keyword
`inventors`	group (list of objects)			Nested group: name it in f ("inventors") for every field of the group, or "inventors.<field>" for one; query its fields in q with the same dotted names.
`inventors.inventor`	string (URL)	returned, not searchable		Link to the detail record: https://patentref.io/api/v1/inventor/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: none: the index has no search field for it, so a query on it matches nothing, as upstream; query the id field of the group instead. It comes back beside that id: f naming the id field or the whole group returns both, and f naming this link alone returns nothing.
`inventors.inventor_id`	string	keyword
`inventors.inventor_name_first`	string	text with a keyword form
`inventors.inventor_name_last`	string	text with a keyword form
`inventors.inventor_gender_code`	string	keyword
`inventors.inventor_location_id`	string	keyword
`inventors.inventor_city`	string	text with a keyword form
`inventors.inventor_state`	string	text with a keyword form
`inventors.inventor_country`	string	text with a keyword form		An ISO 3166-1 alpha-2 country code in capitals, as PatentsView gives it: the United Kingdom is "GB", and "UK" matches nothing.
`inventors.inventor_sequence`	integer	number
`inventors.disambiguated`	boolean	boolean		PatentRef addition: false on rows of weekly grants that no PatentsView release covers yet (names as printed; the ids and what derives from them, such as the links, location ids and the inventor gender code, null); true on PatentsView rows. Present only when f names it (inventors.disambiguated), then on every row; a whole group carries the upstream fields only, so every row of a group has the same keys.
`ipcr`	group (list of objects)			Nested group: name it in f ("ipcr") for every field of the group, or "ipcr.<field>" for one; query its fields in q with the same dotted names.
`ipcr.ipc_id`	string	keyword
`ipcr.ipc_sequence`	integer	number
`ipcr.ipc_action_date`	string	date
`ipcr.ipc_section`	string	keyword
`ipcr.ipc_class`	string	keyword
`ipcr.ipc_subclass`	string	keyword
`ipcr.ipc_main_group`	string	keyword
`ipcr.ipc_subgroup`	string	keyword
`ipcr.ipc_symbol_position`	string	keyword
`ipcr.ipc_classification_data_source`	string	keyword
`ipcr.ipc_classification_value`	string	keyword
`pct_data`	group (list of objects)			Nested group: name it in f ("pct_data") for every field of the group, or "pct_data.<field>" for one; query its fields in q with the same dotted names.
`pct_data.published_filed_date`	string	date
`pct_data.pct_102_date`	string	date
`pct_data.pct_371_date`	string	date
`pct_data.application_kind`	string	keyword
`pct_data.pct_doc_number`	string	keyword
`pct_data.pct_doc_type`	string	keyword
`us_related_documents`	group (list of objects)			Nested group: name it in f ("us_related_documents") for every field of the group, or "us_related_documents.<field>" for one; query its fields in q with the same dotted names.
`us_related_documents.related_doc_type`	string	keyword
`us_related_documents.related_doc_kind`	string	keyword
`us_related_documents.related_doc_number`	string	keyword
`us_related_documents.published_country`	string	keyword		The two-letter office code printed on the grant: mostly the WIPO codes (GB, EP for the European Patent Office, WO for international applications), with "UK" on some older rows.
`us_related_documents.related_doc_published_date`	string	date
`us_related_documents.related_doc_status`	string	keyword
`us_related_documents.related_doc_sequence`	integer	number
`us_related_documents.wipo_kind`	string	keyword
`us_term_of_grant`	group (list of objects)			Nested group: name it in f ("us_term_of_grant") for every field of the group, or "us_term_of_grant.<field>" for one; query its fields in q with the same dotted names.
`us_term_of_grant.term_grant`	string	keyword
`us_term_of_grant.term_extension`	string	keyword
`us_term_of_grant.term_disclaimer`	string	keyword
`us_term_of_grant.disclaimer_date`	string	date
`uspc_at_issue`	group (list of objects)			Nested group: name it in f ("uspc_at_issue") for every field of the group, or "uspc_at_issue.<field>" for one; query its fields in q with the same dotted names.
`uspc_at_issue.uspc_mainclass`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/uspc_mainclass/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`uspc_at_issue.uspc_mainclass_id`	string	keyword
`uspc_at_issue.uspc_subclass`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/uspc_subclass/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`uspc_at_issue.uspc_subclass_id`	string	keyword
`uspc_at_issue.uspc_sequence`	integer	number
`wipo`	group (list of objects)			Nested group: name it in f ("wipo") for every field of the group, or "wipo.<field>" for one; query its fields in q with the same dotted names.
`wipo.wipo_field`	string (URL)	keyword		Link to the detail record: https://patentref.io/api/v1/wipo/<id>/, with a "/" in the id written ":"; null when the id is null. Kind: keyword: in q this name matches the id behind the link (for example "H01" for cpc_current.cpc_class), not the URL.
`wipo.wipo_field_id`	string	keyword
`wipo.wipo_sequence`	integer	number
`lapse`	group (list of objects)			PatentRef addition: expiry and maintenance-fee facts of the patent, one object in a list like every nested group. Returned only when f names it ("lapse" or "lapse.<field>"); not in the default fields. It cannot be used in q or s (400 ERR_Q: q gives the reason "the 'lapse' group is returned with f only", s "Invalid field: lapse.<field>"). Record facts with their basis and an as-of date, never a legal conclusion.
`lapse.expiry_status`	string: active, expired_term, expired_fee_nonpayment, withdrawn, unknown	returned when f names it		Status from the record facts: the term end computed from the dates, and the maintenance-fee events. A maintenance-fee lapse whose 6-month grace period ran out after the computed term end gives expired_term, not expired_fee_nonpayment, and the basis keeps fee_lapse:<YYYY-MM-DD>. Where the USPTO 35 USC 156 list gives an earlier term end than the record's dates and the record shows no terminal disclaimer, the later of the two is the computed term end for this test; if only one of the two has passed, the status is unknown, or expired_fee_nonpayment when the fee record shows an unreinstated lapse whose grace period ran out before the later date. Where the record contradicts the filing date of a parent the term could count from and PatentRef holds no other USPTO record that gives that date, there is no computed term end: the status is the one the record's dates give on the date the row gives, when that date is a possible filing date, and on every filing date the parent's number allows (from 1978-06-01 when the number names no possible year or a serial its office never reached in that year), and unknown when those give different statuses. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.expiry_date_estimated`	string	returned when f names it		End of the statutory term, computed (35 USC 154) from dates in the USPTO record; not a date the record prints. Utility and plant patents: 20 years from the filing date (for a national stage under 35 USC 371, its international filing date, 35 USC 363), or from the earliest filing date of a parent application the record lists (continuation, division or continuation-in-part, including a parent international application the record lists as a related publication; a provisional or foreign priority date does not count), plus the patent term adjustment. A parent's filing date that the record itself contradicts is not used: an international application dated outside the year its number names (PCT/CCYYYY/; PCT/CCYY/ names its year up to 2003, and a later number written that way is read as 20YY when the row's date falls in that year; a number written without one or both slashes, such as PCTGB9300583, is read as PCT/GB93/00583) or before 1978-06-01, or whose number names no possible filing year (including a later PCT/CCYY/ number dated outside 20YY), or a US application dated outside the years in which applications of its serial number's series were filed; PatentRef also does not use a US parent date before 1950. The filing date another USPTO record PatentRef holds gives for the same application counts instead (another row of the same record, the international filing date in the record of its national stage, or the filing date in the record of the patent granted on it); when none does and that parent could be the earliest, this field is null. Filed before 1995-06-08: 17 years from grant when that ends before 1995-06-08 or after the 20-year date, else the 20-year date (basis then names term_17y or term_20y, whichever applied). Design patents: 14 years from grant, 15 when filed on or after 2015-05-13. A dated terminal disclaimer ends the term at its date. A patent or reissue on the USPTO list of patent terms extended under 35 USC 156 takes the list's original expiration date plus the extension the list gives (basis pte_156:<days>); an extension only adds to the original term (35 USC 156(a)), so where the list's date is earlier than the term computed from the record and the record shows no terminal disclaimer, the two disagree, and when only one of the two dates has passed this field is null and the status is unknown, or expired_fee_nonpayment when the fee record shows an unreinstated lapse whose grace period ran out before the later date. Not counted: a terminal disclaimer that ties the term to another patent, an extension the list does not name (an interim extension, or one granted after the list's update date), and any change to the adjustment after grant. Null for a patent withdrawn from issue, for a reissue not on the list, and when the record lacks the dates. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.expiry_basis`	array	returned when f names it		Basis codes: term_20y, term_17y, term_14y, term_15y (the term rule that applied), pta_days:<N> (patent term adjustment), terminal_disclaimer, fee_lapse:<YYYY-MM-DD> (the date of the maintenance-fee record's expiry entry for non-payment), reinstated:<YYYY-MM-DD> (a later reinstatement, EXPX or PMFG in the fee record), pte_156:<N> (the patent is on the USPTO list of patent terms extended under 35 USC 156; N is the extension in days, added to the list's original expiration date). Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.reinstatement_possible`	: True, False, unknown	returned when f names it		37 CFR 1.378: false once the term has ended or nothing lapsed; "unknown" for an unreinstated fee lapse. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.fee_status`	string	returned when f names it		"lapsed" when the USPTO maintenance-fee record shows an expiry for non-payment with no later reinstatement; null otherwise. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.lapse_date`	string	returned when f names it		Date of the expiry entry (EXP.) in the maintenance-fee record. The patent expired at the end of the fee's 6-month grace period (35 USC 41(b)), which is this date or earlier. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.reinstated_date`	string	returned when f names it		Date of the last reinstatement event (EXPX or PMFG) in the fee record. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.prior`	number	returned when f names it		Lapse history-match score (sum of log2 lifts of the traits that fired); null until the scores are computed on the server. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.prior_pct`	number	returned when f names it		Percentile of prior among the expired patents that are still quiet (0 to 100); null until computed. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.fwd_early`	integer	returned when f names it		Direct forward citations within 10 years of grant: US utility patents citing it, in PatentsView and in the weekly grants added after it. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.fwd_late`	integer	returned when f names it		Direct forward citations 15 or more years after grant, counted as fwd_early is. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.sleeper_flag`	boolean	returned when f names it		Expired, and quiet: at most 5 forward citations and at most 1 recent one. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.as_of`	string	returned when f names it		As-of date of the data the record was computed from (the release date of the build). Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.
`lapse.data_version`	string	returned when f names it		data_version of the Lapse catalog the group was read from. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q.

Machine-readable: this page's data as JSON, and the operation in openapi.json (operationId PatentList).