--- title: "Search patents" method: GET path: "/api_partner/evidence/patents" tags: ["Evidence"] --- # Search patents `GET /api_partner/evidence/patents` ## Query parameters - `q` string, nullable — Free-text query. Supports boolean operators (AND, OR, NOT) and phrase matching. - `f` string, nullable — Space-delimited filters in `field:"value"` format. Values must be double-quoted. See the Evidence tag description for examples. - `p` integer — Page number - `s` '_relevance' | 'forwardCitationCount' | 'familySize' | 'patents.publications.pubRef.date' | 'patents.appRef.filingDate' — Sort field. Options: _relevance (default), forwardCitationCount, familySize, patents.publications.pubRef.date, patents.appRef.filingDate - `sortDir` 'asc' | 'desc' — Sort direction. Ignored when s is _relevance. ## Headers - `authorization` string — Set to `Bearer ` to pass token for authorization. ## Response `200` Successful Response - PatentSearchResponse - `totalResults` integer, nullable - `delay` number, nullable - `resultsPerPage` integer, nullable - `from` integer, nullable - `results` PatentFamily[] - `patents` Patent[] - `slug` string, nullable - `familyId` string, nullable - `title` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - string - `abstract` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - string - `tags` FacetValue[] - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `filingStatus` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `classifications` Classification[] - `cpcSymbol` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `position` string, nullable - `inventors` Inventor[] - `name` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `normalizedName` string, nullable - `assignees` Assignee[] - `name` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `normalizedName` string, nullable - `country` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `orgType` FacetValue[] - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `applicants` Assignee[] - `name` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `normalizedName` string, nullable - `country` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `orgType` FacetValue[] - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - `appRef` AppRef - `docId` string, nullable - `patentOffice` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - string - `docNumber` string, nullable - `kind` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - string - `filingDate` string, date-time, nullable - `epodoc` EpodocRef - `docNumber` string, nullable - `kind` string, nullable - `original` OriginalRef - `docNumber` string, nullable - `kind` string, nullable - `name` string, nullable - `publications` Publication[] - `ids` string[] - `docId` string, nullable - `familyId` string, nullable - `filingStatus` string, nullable - `pubRef` PubRef - `country` string, nullable - `docNumber` string, nullable - `kind` string, nullable - `year` integer, nullable - `date` string, date-time, nullable - `epodoc` EpodocRef - `docNumber` string, nullable - `kind` string, nullable - `original` OriginalRef - `docNumber` string, nullable - `kind` string, nullable - `name` string, nullable - `appRef` AppRef - `docId` string, nullable - `patentOffice` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - … - string - `docNumber` string, nullable - `kind` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - … - string - `filingDate` string, date-time, nullable - `epodoc` EpodocRef - `docNumber` string, nullable - `kind` string, nullable - `original` OriginalRef - `docNumber` string, nullable - `kind` string, nullable - `name` string, nullable - `inventors` Inventor[] - `name` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - `normalizedName` string, nullable - `assignees` Assignee[] - `name` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - `normalizedName` string, nullable - `country` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - `orgType` FacetValue[] - `id` union - … - `name` union - … - `highlighted` string, nullable - `applicants` Assignee[] - `name` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - `normalizedName` string, nullable - `country` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - `orgType` FacetValue[] - `id` union - … - `name` union - … - `highlighted` string, nullable - `classifications` Classification[] - `cpcSymbol` FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - `position` string, nullable - `priorityClaims` PriorityClaim[] - `country` string, nullable - `docNumber` string, nullable - `year` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - … - integer - `id` string, nullable - `usptoPath` string, nullable - `externalLink` string, nullable - `backwardCitationCount` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - … - `name` union - … - `highlighted` string, nullable - integer - `compounds` Compound[] - `compoundComplexity` string, nullable - `exactMatch` string, nullable - `logPXlogp3Aa` string, nullable - `massExact` string, nullable - `molecularWeight` string, nullable - `languages` Language[] - `id` string, nullable - `name` string, nullable - `highlighted` string, nullable - `id` string, nullable - `legalEvents` object, nullable - `patentsTotal` integer, nullable - `slug` string, nullable - `dataset` string, nullable - `uid` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - string - `forwardCitationCount` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - integer - `familySize` union - FacetValue — A faceted field value as returned by Resolute's formatter. Resolute returns faceted fields as {id, name} dicts, optionally with a "highlighted" key containing HTML-marked-up text when the field matched the search query. The id is the ES-stored value (filterable), and name is the display value (may differ due to es_to_name transforms, e.g. country codes). - `id` union - string - integer - number - `name` union - string - integer - `highlighted` string, nullable - integer - `familyId` string, nullable - `id` string, nullable ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/scite/apis/scite-api.md) · [All operations](https://skmtc.net/scite/apis/scite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scite/scite-api/versions/9f4cba020e89/schema)