{
 "endpoint": "/api/v1/inventor/",
 "data_version": "20261027.2",
 "as_of": "2026-10-27",
 "routes": [
  "/api/v1/inventor/",
  "/api/v1/inventor/{pk}/"
 ],
 "aliases": [],
 "response_key": "inventors",
 "default_f": [
  "inventor_id",
  "inventor_name_first",
  "inventor_name_last"
 ],
 "default_s": [
  {
   "inventor_id": "asc"
  }
 ],
 "default_o": {},
 "sortable_fields": [
  "inventor_id",
  "inventor_name_first",
  "inventor_name_last",
  "inventor_gender_code",
  "inventor_lastknown_latitude",
  "inventor_lastknown_longitude",
  "inventor_num_patents",
  "inventor_num_assignees",
  "inventor_first_seen_date",
  "inventor_last_seen_date",
  "inventor_years_active"
 ],
 "nested_groups": [
  "inventor_years"
 ],
 "q_required": true,
 "detail_key": "inventor_id",
 "in_this_build": true,
 "fields": [
  {
   "name": "inventor_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "inventor_name_first",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "inventor_name_last",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "inventor_gender_code",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "inventor_lastknown_city",
   "type": "string",
   "kind": "text"
  },
  {
   "name": "inventor_lastknown_state",
   "type": "string",
   "kind": "text"
  },
  {
   "name": "inventor_lastknown_country",
   "type": "string",
   "kind": "text",
   "note": "An ISO 3166-1 alpha-2 country code in capitals, as PatentsView gives it: the United Kingdom is \"GB\", and \"UK\" matches nothing."
  },
  {
   "name": "inventor_lastknown_latitude",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "inventor_lastknown_longitude",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "inventor_lastknown_location",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "Link to the detail record: https://patentref.io/api/v1/location/<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."
  },
  {
   "name": "inventor_num_patents",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "inventor_num_assignees",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "inventor_first_seen_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "inventor_last_seen_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "inventor_years_active",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "inventor_years",
   "type": "group (list of objects)",
   "kind": "",
   "note": "Nested group: name it in f (\"inventor_years\") for every field of the group, or \"inventor_years.<field>\" for one; query its fields in q with the same dotted names."
  },
  {
   "name": "inventor_years.year",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "inventor_years.num_patents",
   "type": "integer",
   "kind": "number"
  }
 ],
 "operation_id": "InventorList"
}