{
 "endpoint": "/api/v1/publication/",
 "data_version": "20261027.2",
 "as_of": "2026-10-27",
 "routes": [
  "/api/v1/publication/",
  "/api/v1/publication/{pk}/"
 ],
 "aliases": [],
 "response_key": "publications",
 "default_f": [
  "document_number",
  "publication_title",
  "publication_date"
 ],
 "default_s": [
  {
   "document_number": "asc"
  }
 ],
 "default_o": {},
 "sortable_fields": [
  "document_number",
  "publication_type",
  "publication_date",
  "publication_year",
  "publication_kind",
  "series_code",
  "rule_47_flag"
 ],
 "nested_groups": [
  "assignees",
  "cpc_at_issue",
  "cpc_current",
  "foreign_priority",
  "gov_interest_organizations",
  "granted_pregrant_crosswalk",
  "inventors",
  "ipcr",
  "pct_data",
  "us_parties",
  "us_related_documents",
  "uspc_at_issue",
  "wipo"
 ],
 "q_required": true,
 "detail_key": "document_number",
 "in_this_build": false,
 "fields": [
  {
   "name": "document_number",
   "type": "integer",
   "kind": "keyword"
  },
  {
   "name": "publication_title",
   "type": "string",
   "kind": "text"
  },
  {
   "name": "publication_type",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "publication_country",
   "type": "string",
   "kind": "returned, not searchable"
  },
  {
   "name": "publication_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "publication_year",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "publication_abstract",
   "type": "string",
   "kind": "text"
  },
  {
   "name": "publication_kind",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "publication_application_number",
   "type": "integer",
   "kind": "returned, not searchable"
  },
  {
   "name": "series_code",
   "type": "integer",
   "kind": "keyword"
  },
  {
   "name": "rule_47_flag",
   "type": "boolean",
   "kind": "boolean"
  },
  {
   "name": "assignees",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "assignees.assignee",
   "type": "string (URL)",
   "kind": "returned, not searchable",
   "note": "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."
  },
  {
   "name": "assignees.assignee_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "assignees.assignee_type",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "assignees.assignee_individual_name_first",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignees.assignee_individual_name_last",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignees.assignee_organization",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignees.assignee_location_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "assignees.assignee_city",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignees.assignee_state",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "assignees.assignee_country",
   "type": "string",
   "kind": "text with a keyword form",
   "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": "assignees.assignee_sequence",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "cpc_at_issue",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "cpc_at_issue.cpc_sequence",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "cpc_at_issue.cpc_section_id",
   "type": "string",
   "kind": "returned, not searchable"
  },
  {
   "name": "cpc_at_issue.cpc_class",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "cpc_at_issue.cpc_class_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "cpc_at_issue.cpc_subclass",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "cpc_at_issue.cpc_subclass_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "cpc_at_issue.cpc_group",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "cpc_at_issue.cpc_group_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "cpc_at_issue.action_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "cpc_at_issue.document_number",
   "type": "integer",
   "kind": "returned, not searchable"
  },
  {
   "name": "cpc_current",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "cpc_current.cpc_sequence",
   "type": "number",
   "kind": "number"
  },
  {
   "name": "cpc_current.cpc_section_id",
   "type": "string",
   "kind": "returned, not searchable"
  },
  {
   "name": "cpc_current.cpc_class",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "cpc_current.cpc_class_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "cpc_current.cpc_subclass",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "cpc_current.cpc_subclass_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "cpc_current.cpc_group",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "cpc_current.cpc_group_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "cpc_current.action_date",
   "type": "string",
   "kind": "returned, not searchable"
  },
  {
   "name": "cpc_current.document_number",
   "type": "integer",
   "kind": "returned, not searchable"
  },
  {
   "name": "foreign_priority",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "foreign_priority.priority_claim_kind",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "foreign_priority.foreign_application_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "foreign_priority.filing_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "foreign_priority.foreign_country_filed",
   "type": "string",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "foreign_priority.priority_claim_sequence",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "gov_interest_organizations",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "gov_interest_organizations.fedagency_name",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "gov_interest_organizations.level_one",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "gov_interest_organizations.level_two",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "gov_interest_organizations.level_three",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "granted_pregrant_crosswalk",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "granted_pregrant_crosswalk.patent_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "granted_pregrant_crosswalk.document_number",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "granted_pregrant_crosswalk.application_number",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "granted_pregrant_crosswalk.current_document_number_flag",
   "type": "boolean",
   "kind": "boolean"
  },
  {
   "name": "granted_pregrant_crosswalk.current_patent_id_flag",
   "type": "boolean",
   "kind": "boolean"
  },
  {
   "name": "inventors",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "inventors.inventor",
   "type": "string (URL)",
   "kind": "returned, not searchable",
   "note": "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."
  },
  {
   "name": "inventors.inventor_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "inventors.inventor_name_first",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "inventors.inventor_name_last",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "inventors.inventor_gender_code",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "inventors.inventor_location_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "inventors.inventor_city",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "inventors.inventor_state",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "inventors.inventor_country",
   "type": "string",
   "kind": "text with a keyword form",
   "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": "inventors.inventor_sequence",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "ipcr",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "ipcr.ipc_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_sequence",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "ipcr.ipc_action_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "ipcr.ipc_section",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_class",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_subclass",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_main_group",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_subgroup",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_symbol_position",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_classification_data_source",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_classification_value",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_class_level",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "ipcr.ipc_class_status",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "pct_data",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "pct_data.published_filed_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "pct_data.pct_371_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "pct_data.pct_102_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "pct_data.application_kind",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "pct_data.pct_doc_number",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "pct_data.pct_doc_type",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "pct_data.filed_country",
   "type": "string",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "us_related_documents",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "us_related_documents.related_doc_type",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "us_related_documents.related_doc_kind",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "us_related_documents.related_doc_number",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "us_related_documents.published_country",
   "type": "string",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "us_related_documents.related_doc_published_date",
   "type": "string",
   "kind": "date"
  },
  {
   "name": "us_related_documents.related_doc_sequence",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "us_parties",
   "type": "group (list of objects)",
   "kind": "",
   "note": "Nested group: name it in f (\"us_parties\") for every field of the group, or \"us_parties.<field>\" for one; query its fields in q with the same dotted names."
  },
  {
   "name": "us_parties.us_party_type",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "us_parties.us_party_designation",
   "type": "string",
   "kind": "text"
  },
  {
   "name": "us_parties.location_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "us_parties.us_party_name_first",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "us_parties.us_party_name_last",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "us_parties.us_party_organization",
   "type": "string",
   "kind": "text with a keyword form"
  },
  {
   "name": "us_parties.us_party_sequence",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "us_parties.applicant_authority",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "uspc_at_issue",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "uspc_at_issue.uspc_mainclass",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "uspc_at_issue.uspc_mainclass_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "uspc_at_issue.uspc_subclass",
   "type": "string (URL)",
   "kind": "keyword",
   "note": "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."
  },
  {
   "name": "uspc_at_issue.uspc_subclass_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "uspc_at_issue.uspc_sequence",
   "type": "integer",
   "kind": "number"
  },
  {
   "name": "wipo",
   "type": "group (list of objects)",
   "kind": "",
   "note": "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."
  },
  {
   "name": "wipo.wipo_field_id",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "wipo.wipo_field",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "wipo.wipo_sector_title",
   "type": "string",
   "kind": "keyword"
  },
  {
   "name": "wipo.wipo_sequence",
   "type": "integer",
   "kind": "number"
  }
 ],
 "operation_id": "PublicationList"
}