/api/v1/wipo/
In data version 20261027.2 this endpoint answers 501 ERR_NOT_IMPLEMENTED: wipo: /api/v1/wipo/ (each patent's WIPO fields come in its wipo group).
Upstream view WIPOList (index wipo, response key wipo). Any field may be null where the bulk data has no value. Default fields (f): wipo_id, sector_title, field_title. Default sort (s): [{"wipo_id": "asc"}]. A lookup endpoint: q may be omitted to list every record. When the build in service does not carry this endpoint's data set it answers 501 with X-Status-Reason-Code ERR_NOT_IMPLEMENTED and X-Status-Reason naming the data set.
- Routes
GETPOST/api/v1/wipo/GETPOST/api/v1/wipo/{pk}/- Response key
wipo- Default f
wipo_id,sector_title,field_title- Default s
[{"wipo_id": "asc"}]- Default o
{}- q
- may be omitted (a lookup endpoint lists every record)
- Detail key
wipo_idin the path; a "/" in a key is written ":"
Example
curl -s -G -H "X-Api-Key: $KEY" https://patentref.io/api/v1/wipo/ \
--data-urlencode 'o={"size": 10}'
import json, os, requests
base_url = "https://patentref.io"
headers = {"X-Api-Key": os.environ["PATENTREF_KEY"]}
params = {"o": {"size": 10}}
r = requests.get(base_url + "/api/v1/wipo/", 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["wipo"][:3])
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 |
|---|---|---|---|---|
wipo_id | string | keyword | yes | |
sector_title | string | keyword | yes | |
field_title | string | keyword | yes |
Machine-readable: this page's data as JSON, and the operation in openapi.json (operationId WIPOList).