General information
The Special Information System (SIS) API was designed to easily receive information about intellectual property rights in JSON format and further create your own databases, for data analysis, statistics, etc. The API works on the HTTPS protocol.
The SIS API is available at: https://sis.nipo.gov.ua/api/v1/open-data/
API components
The SIS API contains information included in the State Registers of Intellectual Property Rights:
- the State Register of Patents of Ukraine for Inventions;
- the State Register of Patents of Ukraine for Utility Models;
- the State Register of Ukraine for Semiconductor Product Layouts;
- the State Register of Certificates of Ukraine for Marks for Goods and Services;
- the State Register of Ukraine for Geographical Indications;
- the State Register of Patents of Ukraine for Industrial Designs;
- the State Register of Certificates for Registration of Copyright to a Work;
- the State Register of Agreements Relating to Copyright in Works.
The SIS API also contains information on applications for marks for goods and services (trademarks) submitted to the examining authority.
Description of the API parameters
By GET-parameters you can filter the retrieved data. As of today the list of the available parameters is the following:
# | Parameter name | Description | Data type | Mandatory | Possible parameter value |
---|---|---|---|---|---|
1. | obj_type | Type of an intellectual property right | Integer | No |
|
2. | obj_state | Status of an intellectual property right | Integer | No |
|
3. | app_date_from | Application date (from) | Date | No | Date format dd.mm.yyyy |
4. | app_date_to | Application date (to) | Date | No | Date format dd.mm.yyyy |
5. | reg_date_from | Date of issue of a title of protection (from) | Date | No | Date format dd.mm.yyyy |
6. | reg_date_to | Date of issue of a title of protection (to) | Date | No | Date format dd.mm.yyyy |
7. | last_update_from | Last update of an entry (from) | Date | No | Date format dd.mm.yyyy |
8. | last_update_to | Last update of an entry (to) | Date | No | Date format dd.mm.yyyy |
9. | app_number | Application number | String | No | Application number |
Getting data for one IP object
If you want to get single object data, you can use the number of an application or an registration number.
Examples:
- https://sis.nipo.gov.ua/api/v1/open-data/m202011127/ - receiving application m202011127 data.
- https://sis.nipo.gov.ua/api/v1/open-data/319040/ - receiving registration 319040 data.
To specify the type of industrial property object, use the obj_type GET parameter (see above for possible values). For example, https://sis.nipo.gov.ua/api/v1/open-data/2000010059/?obj_type=4.
Limitations:
One query per second.
Examples of queries:
- https://sis.nipo.gov.ua/api/v1/open-data/?obj_state=1&obj_type=4&app_date_from=01.06.2020&app_date_to=20.06.2020 – returns the list of applications for marks for goods and services (trademarks) submitted within the period from 01.06.2020 to 20.06.2020.
- https://sis.nipo.gov.ua/api/v1/open-data/?obj_type=4&app_date_from=01.06.2020&app_date_to=20.06.2020 – returns the list of applications for marks for goods and services (trademarks) and titles of protection for marks for goods and services (trademarks) with the application filing date within the period from 01.06.2020 to 20.06.2020.
- https://sis.nipo.gov.ua/api/v1/open-data/?obj_state=1&obj_type=4&app_date_from=01.06.2020&app_date_to=20.06.2020&last_update_from=10.06.2020&last_update_to=20.06.2020 – returns the list of trademark applications submitted within the period from 01.06.2020 to 20.06.2020 but which have changes made within the period from 10.06.2020 to 20.06.2020.
- https://sis.nipo.gov.ua/api/v1/open-data/?obj_state=1&obj_type=4&last_update_from=10.06.2020&last_update_to=20.06.2020 – returns the list of trademark applications that have changes made within the peri from 10.06.2020 to 20.06.2020.
- https://sis.nipo.gov.ua/api/v1/open-data/?obj_state=2®_date_from=01.06.2019 – returns the list of titles of protection where the date of issue of a title of protection is prior or equal to 01.06.2019.