{
 "endpoint": "/api/v1/assignee/",
 "data_version": "20261027.2",
 "as_of": "2026-10-27",
 "routes": [
  "/api/v1/assignee/",
  "/api/v1/assignee/{pk}/"
 ],
 "aliases": [],
 "response_key": "assignees",
 "default_f": [
  "assignee_id",
  "assignee_individual_name_first",
  "assignee_individual_name_last",
  "assignee_organization"
 ],
 "default_s": [
  {
   "assignee_id": "asc"
  }
 ],
 "default_o": {},
 "sortable_fields": [
  "assignee_id",
  "assignee_individual_name_first",
  "assignee_individual_name_last",
  "assignee_organization",
  "assignee_type",
  "assignee_lastknown_latitude",
  "assignee_lastknown_longitude",
  "assignee_first_seen_date",
  "assignee_last_seen_date",
  "assignee_num_inventors",
  "assignee_num_patents",
  "assignee_years_active"
 ],
 "nested_groups": [
  "assignee_years"
 ],
 "q_required": true,
 "detail_key": "assignee_id",
 "in_this_build": true,
 "fields": [
  {
   "name": "assignee_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "assignee_individual_name_first",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignee_individual_name_last",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignee_organization",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignee_type",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "assignee_lastknown_city",
   "type": "string",
   "kind": "text"
  },
  {
   "name": "assignee_lastknown_state",
   "type": "string",
   "kind": "text"
  },
  {
   "name": "assignee_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": "assignee_lastknown_latitude",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "assignee_lastknown_longitude",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "assignee_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": "assignee_first_seen_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "assignee_last_seen_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "assignee_num_inventors",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "assignee_num_patents",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "assignee_years_active",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "assignee_years",
   "type": "group (list of objects)",
   "kind": "",
   "note": "Nested group: name it in f (\"assignee_years\") for every field of the group, or \"assignee_years.<field>\" for one; query its fields in q with the same dotted names."
  },
  {
   "name": "assignee_years.year",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "assignee_years.num_patents",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "raw_assignee_individual_name_first",
   "type": "string",
   "kind": "returned when f names it",
   "note": "PatentRef addition: the first name as printed on the grant of the assignee's most recent patent, the patent its other names come from (PatentsView g_assignee_not_disambiguated), beside the disambiguated name, which is PatentsView's one label for a whole cluster of names. Present only when f names it (raw_assignee_individual_name_first), then on every record; null where the bulk data has none or the data in service predates it. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q."
  },
  {
   "name": "raw_assignee_individual_name_last",
   "type": "string",
   "kind": "returned when f names it",
   "note": "PatentRef addition: the last name as printed on the grant of the assignee's most recent patent, the patent its other names come from (PatentsView g_assignee_not_disambiguated), beside the disambiguated name, which is PatentsView's one label for a whole cluster of names. Present only when f names it (raw_assignee_individual_name_last), then on every record; null where the bulk data has none or the data in service predates it. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q."
  },
  {
   "name": "raw_assignee_organization",
   "type": "string",
   "kind": "returned when f names it",
   "note": "PatentRef addition: the organization's name as printed on the grant of the assignee's most recent patent, the patent its other names come from (PatentsView g_assignee_not_disambiguated), beside the disambiguated name, which is PatentsView's one label for a whole cluster of names. Present only when f names it (raw_assignee_organization), then on every record; null where the bulk data has none or the data in service predates it. Kind: f-only. Returned when f names it; q or s on it answers 400 ERR_Q."
  }
 ],
 "operation_id": "AssigneeList"
}