Introduction
The EU Pollinator Hub is an integrative tool to centralise, analyse and visualise bee and pollinator-related data based on principles of collaboration and conservation.
Bees and other insect pollinators are becoming increasingly relevant in the public debate. European authorities now recognise the environmental risks pollinators face and the need for institutional action. Given their importance for ecosystems and their role in our food security, the commitment to protect pollinators has been growing, and data is essential to fulfilling this commitment.
Different agents and stakeholders are continually collecting data related to the status of pollinators, such as researchers, environmental, health or agricultural authorities, national beekeeping or farming associations. The EU Pollinator Hub has been conceived to valorise their efforts and improve collaborations based on data-sharing. At the same time, the EU Pollinator Hub is constantly developing to provide access to valuable data from different consenting sources. In a collaborative spirit, the EU Pollinator Hub centralises and presents this data, also working as a communicative tool for the benefit of bees and pollinators in general.
The EU Pollinator Hub is coordinated by BeeLife European Beekeeping Coordination, an NGO focused on the protection of pollinators and biodiversity in Europe. BeeLife has initialised the first stages of this integrative platform within the Internet of Bees (IoBee) project.
The EU Pollinator Hub is also an attempt to materialise the conclusions of the EU Bee Partnership regarding the need for further bee-data integration. The partnership is a stakeholder platform dynamised by the European Food Safety Authority that includes representatives from the beekeeping and farming sectors, NGOs, veterinarians, academia, industry, producers, and scientists.
This new tool also includes developments from the Apimondia working group on the standardisation of data on bees - Bee XML. Bee XML is the ongoing measure to reach a new model for sharing bee data, and the EU Pollinator Hub aims at implementing these standards.
This documentation aims to provide all the information you need to work with our API.
Authenticating requests
To authenticate requests, include an Authorization
header with the value "Bearer {YOUR_AUTH_KEY}"
.
All authenticated endpoints are marked with a requires authentication
badge in the documentation below.
You can retrieve your token by visiting your dashboard and clicking API Tokens.
Discovery
Publicly accessible routes, that do not require any special permissions.
Pipeline health check
requires authentication
Tests whether the API functions according to expectations. Should return "status": "OK" when successful.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/status" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/status';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/status"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/status'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 59
access-control-allow-origin: *
{
"status": "OK"
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
List datasets
requires authentication
Get a list of all publicly accessible datasets. Does not return all metadata fields contained within the dataset. Only returns datasets with completely integrated data. Note, list contains publicly inaccessible datasets as well (see attribute public). Uses pagination.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=1&limit=3" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'page' => '1',
'limit' => '3',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/discovery/datasets"
);
const params = {
"page": "1",
"limit": "3",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets'
params = {
'page': '1',
'limit': '3',
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
Example response (200):
Show headers
cache-control: cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 58
access-control-allow-origin: *
{
"current_page": 1,
"data": [
{
"id": 2,
"uid": "CNTRS2.0.0",
"name": "Countries",
"long_name": "EUPH reference dataset containing names and codes of countries, aggregates and subdivisions of countries",
"description": "The dataset contains standardised information on countries published by the Organization for Standardization (ISO) and the United Nations Statistics Division (UNSD).",
"featured_image": null,
"status": "publish",
"public": false,
"licence": "EU Pollinator Hub",
"published_at": "2023-01-25T23:00:00.000000Z",
"created_at": "2023-01-26T18:18:06.000000Z",
"updated_at": "2025-04-18T09:26:56.000000Z"
},
{
"id": 20,
"uid": "LNGGE20.0.0",
"name": "Language",
"long_name": "Partial content of ISO 639 containing information on languages",
"description": "This dataset contains information on languages spoken worldwide and contained in ISO 639-3:2007 (codes for the representation of names of languages — Part 3: Alpha-3 code for comprehensive coverage of languages) as well as official languages in the European Union, as defined in Regulation No 1 from 1958, as amended, determining the languages to be used by the European Economic Community.",
"featured_image": null,
"status": "publish",
"public": false,
"licence": "EU Pollinator Hub",
"published_at": "2023-03-22T23:00:00.000000Z",
"created_at": "2023-01-26T18:18:06.000000Z",
"updated_at": "2024-01-26T17:32:58.000000Z"
},
{
"id": 27,
"uid": "PHRFR27.0.0",
"name": "EUPH Reference licences",
"long_name": "List of licences by which datasets are published on the EU Pollinator Hub",
"description": "The dataset contains all licences for data hosted on the EUPH.",
"featured_image": null,
"status": "publish",
"public": false,
"licence": "CC BY 4.0",
"published_at": "2023-03-27T22:00:00.000000Z",
"created_at": "2023-09-01T08:53:39.000000Z",
"updated_at": "2024-02-01T14:25:03.000000Z"
}
],
"first_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=1",
"from": 1,
"last_page": 4,
"last_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=4",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=1",
"label": "1",
"active": true
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=2",
"label": "2",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=3",
"label": "3",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=4",
"label": "4",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=2",
"label": "Next »",
"active": false
}
],
"next_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=2",
"path": "https://app.pollinatorhub.eu/api/v1/discovery/datasets",
"per_page": 3,
"prev_page_url": null,
"to": 3,
"total": 11
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of Datasets available to the User.
*
object
uid
string
The unique identifier used to identify the entity within the platform.
name
string
The actual name of the dataset.
long_name
string
The long version of the name of the dataset.
description
string
The abstract of the dataset.
status
string
The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden
public
boolean
1 means that the data of this dataset are public.
licence
string|null
The uid of the licence of this entity.
published_at
string|null
The date and time the dataset was published.
created_at
string
The date and time the dataset was created.
updated_at
string
The date and time the dataset was last updated.
id
integer
The internal id of the dataset.
Show dataset
requires authentication
Get detailed information about specific dataset.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers)
response.json()
Example response (200):
Show headers
cache-control: cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 57
access-control-allow-origin: *
{
"data": {
"id": 80,
"uid": "RGLTN80.0.0",
"name": "Regulation (EU) 2017/269",
"long_name": "The Harmonised classification of substances according to Regulation (EU) 2017/269 amending Regulation (EC) No 1185/2009.",
"description": "The dataset contains the harmonised classification of substances contained in annex III of Commission Regulation (EU) 2017/269 of 16 February 2017 amending Regulation (EC) No 1185/2009 of the European Parliament and of the Council concerning statistics on pesticides, as regards the list of active substances.",
"featured_image": null,
"data_overview": null,
"data_value": null,
"data_description": null,
"data_application": null,
"data_issues": null,
"introduction": null,
"acquisition": null,
"preparation": null,
"validation": null,
"analysis": null,
"status": "publish",
"public": true,
"licence": {
"uid": "cc-by-4-0",
"name": "CC BY 4.0",
"abbreviation": "CC BY 4.0",
"description": "### You are free to:\n\n* Share — copy and redistribute the material in any medium or format for any purpose, even commercially.\n* Adapt — remix, transform, and build upon the material for any purpose, even commercially.\n* The licensor cannot revoke these freedoms as long as you follow the license terms.\n\n### Under the following terms:\n\n* Attribution - You must give appropriate credit , provide a link to the license, and indicate if changes were made . You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.\n* No additional restrictions - You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.\n\n### Notices:\n\nYou do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.\n\nNo warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.\n",
"url_summary": "https://creativecommons.org/licenses/by/4.0/",
"url_legal": "https://creativecommons.org/licenses/by/4.0/legalcode",
"image_url": "/storage/01HF961C5YQASH3TQ6MNYKN9WN.svg"
},
"contacts": [],
"entities": [
{
"id": 3,
"uid": "euph",
"name": "EU Pollinator Hub",
"type": "legal-entity",
"abbreviation": "EUPH",
"created_at": "2023-10-05T10:02:30.000000Z",
"updated_at": "2024-06-04T12:59:02.000000Z"
}
],
"contributors": [],
"parts": [
{
"id": 149,
"uid": "RGLTN80.HRMNS149.0",
"name": "Harmonised classification - CAS",
"description": "The tabe contains the CAS codes corrisponding to a given code of the harmonised classification of substances.",
"featured_image": null,
"structure": null,
"preparation": null,
"changes": null,
"unresolved": null,
"additional_information": null,
"type": "file",
"licence": null,
"columns": [
{
"id": 1216,
"name": "code",
"description": "Code of the Harmonised Classification of Substances",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-13T17:17:11.000000Z",
"updated_at": "2024-01-26T18:23:50.000000Z"
},
{
"id": 1217,
"name": "cas",
"description": "Chemical Abstracts Service registry numbers.",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-13T17:17:11.000000Z",
"updated_at": "2024-01-26T18:23:50.000000Z"
}
],
"data_files": [
{
"id": 282,
"name": "euph_000046_eu-regulation-2017-269_table_harmonised_cas.csv",
"description": null,
"status": "analyzed",
"type": "csv",
"mimetype": "text/csv",
"file_size": 11843,
"download_count": 0,
"created_at": "2023-12-13T17:17:40.000000Z",
"updated_at": "2023-12-13T17:17:40.000000Z"
}
],
"supplemental_files": [],
"created_at": "2023-12-13T16:40:42.000000Z",
"updated_at": "2024-01-25T09:26:58.000000Z"
},
{
"id": 150,
"uid": "RGLTN80.HRMNS150.0",
"name": "Harmonised classification - CIPAC",
"description": "The tabe contains the CIPA codes corrisponding to a given code of the harmonised classification of substances.",
"featured_image": null,
"structure": null,
"preparation": null,
"changes": null,
"unresolved": null,
"additional_information": null,
"type": "file",
"licence": null,
"columns": [
{
"id": 1214,
"name": "code",
"description": "Code of the harmonised classification of substances",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-13T16:41:47.000000Z",
"updated_at": "2024-01-26T18:23:53.000000Z"
},
{
"id": 1215,
"name": "cibac",
"description": "Code of the Collaborative International Pesticides Analytical Council.",
"descriptor": {
"id": 314,
"uid": "0.0.DCMLN314",
"namespace": null,
"name": "DecimalNumber",
"description": "> Any of the rational or irrational numbers.",
"class": "[EUPH-code: 7325]",
"unit": null,
"created_at": null,
"updated_at": "2025-01-12T10:31:26.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-13T16:41:47.000000Z",
"updated_at": "2024-01-26T18:23:53.000000Z"
}
],
"data_files": [
{
"id": 280,
"name": "euph_000046_eu-regulation-2017-269_table_harmonised_cibac.csv",
"description": null,
"status": "analyzed",
"type": "csv",
"mimetype": "text/csv",
"file_size": 9522,
"download_count": 0,
"created_at": "2023-12-13T16:41:46.000000Z",
"updated_at": "2023-12-13T16:41:47.000000Z"
}
],
"supplemental_files": [],
"created_at": "2023-12-13T16:41:32.000000Z",
"updated_at": "2024-01-25T09:26:58.000000Z"
},
{
"id": 151,
"uid": "RGLTN80.HRMNS151.0",
"name": "Harmonised classification",
"description": "The table contains a summary of the table in annex III of Commission Regulation (EU) 2017/269 of 16 February 2017 amending Regulation (EC) No 1185/2009 of the European Parliament and of the Council concerning statistics on pesticides, as regards the list of active substances.",
"featured_image": null,
"structure": null,
"preparation": null,
"changes": null,
"unresolved": null,
"additional_information": null,
"type": "file",
"licence": null,
"columns": [
{
"id": 1219,
"name": "id",
"description": "Identifier of the record.",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-15T14:58:18.000000Z",
"updated_at": "2024-01-26T18:23:54.000000Z"
},
{
"id": 1220,
"name": "code",
"description": "Code of the harmonised classification of substances",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-15T14:58:18.000000Z",
"updated_at": "2024-01-26T18:23:54.000000Z"
},
{
"id": 1221,
"name": "description",
"description": "Name of of the item.",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-15T14:58:18.000000Z",
"updated_at": "2024-01-26T18:23:54.000000Z"
},
{
"id": 1222,
"name": "aggregate",
"description": "Aggregate level of the reported item (majorgroups: highest aggregation level, major groups in the harmonised classification of substances; category: second aggregation level, categories of products; class: third aggregation level, chemical classes; substance: fourth aggregation level, active substances in plant protection products).",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-15T14:58:18.000000Z",
"updated_at": "2024-01-26T18:23:54.000000Z"
},
{
"id": 1223,
"name": "euph_code",
"description": "Unique identifier of a class on the EU Pollinator Hub.",
"descriptor": {
"id": 313,
"uid": "0.0.NTGER313",
"namespace": null,
"name": "Integer",
"description": "> A number with no fractional part, including the negative and positive numbers as well as zero.",
"class": "[EUPH-code: 7324]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:14:52.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-15T14:58:18.000000Z",
"updated_at": "2024-01-26T18:23:54.000000Z"
},
{
"id": 1224,
"name": "parent",
"description": "Superior aggregate level of the reported item.",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-12-15T14:58:18.000000Z",
"updated_at": "2024-01-26T18:23:54.000000Z"
}
],
"data_files": [
{
"id": 285,
"name": "euph_000046_eu-regulation-2017-269_table_harmonised_classification.csv",
"description": null,
"status": "analyzed",
"type": "csv",
"mimetype": "text/csv",
"file_size": 45132,
"download_count": 0,
"created_at": "2023-12-15T14:58:18.000000Z",
"updated_at": "2023-12-15T14:58:18.000000Z"
}
],
"supplemental_files": [],
"created_at": "2023-12-15T14:58:05.000000Z",
"updated_at": "2024-01-25T09:26:58.000000Z"
}
],
"descriptors": [],
"published_at": "2023-12-13T23:00:00.000000Z",
"created_at": "2023-12-13T16:37:54.000000Z",
"updated_at": "2025-02-09T09:41:13.000000Z"
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of metadata associated with the requested dataset.
uid
string
The unique identifier used to identify the entity within the platform.
name
string
The actual name of the dataset.
long_name
string
The long version of the name of the dataset.
description
string
Abstract about the dataset. Uses Markdown for styling.
data_overview
string
Concise information (less than 200 words) about: e.g. provider of the data (who?); origin of the data and the subject area covered by the dataset (what?); geographical origin of the data (where?); time period covered by the dataset (when?). Uses Markdown for styling.
data_value
string
Concise information (less than 200 words) about: e.g. reason for collecting the data; possible benefits resulting from the collection of the data (why?). Uses Markdown for styling.
data_description
string
Concise description (less than 200 words) of the dataset metrics: e.g. number of files; categories of data; size of the datasets in bytes. Uses Markdown for styling.
data_application
string
A concise summary (less than 200 words) of possible applications for which the data could be used, scientific or technical questions or other issues that could be addressed (for what?). Uses Markdown for styling.
data_issues
string
A list of unresolved issues and quality concerns. Uses Markdown for styling.
introduction
string
A longer description about the dataset.Uses Markdown for styling.
acquisition
string
Description of or a reference to material and methods used to acquire the data in the dataset and a detailed list of terms under which the data has been made available (licensing).Uses Markdown for styling.
preparation
string
Detailed description of material (product, model) and methods (provide references if possible) used to prepare the dataset. Uses Markdown for styling.
validation
string
Detailed description of material (product, model) and methods (provide references if possible) used to validate the dataset for the purpose of data quality assessment. Uses Markdown for styling.
analysis
string
Detailed description of material (product, model) and methods (provide references if possible) used to analyse the dataset for the purpose of data quality assessment. Uses Markdown for styling.
status
string
The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden
public
boolean
Value of 1 means that the data of this dataset are publicly accessible.
licence
array|null The licence information of this entity.
name
string
The name of the licence.
abbreviation
string
The short name of the licence.
description
string
The description of the licence.
uid
string
The unique identifier of the licence.
url_summary
string|null
Url to external description of this licence.
url_legal
string|null
Url to external legal definition of this licence.
image_url
string|null
Url to licence image representation.
contact
object[]
A list of contact points for the entity.
type
string
The type of the contact.
value
string
The actual value of the contact, for
entities
string[]
Array containing the uid of the entities of this dataset.
*
string
The Uid of the entity.
contributors
string[]
Array containing the uid of the contributors of this dataset.
*
string
The Uid of the contributor.
parts
string[]
An array containing all related dataset tables. Field is hidden for non-public datasets.
*
object
uid
string
The unique identifier used to identify the table within the platform.
name
string
Name of the table.
description
string
Description of the table. Uses Markdown for styling.
structure
string
An unordered list of potential links between columns of the same file, of different files of the same dataset or of different files of different datasets as follows: Column [dataset].[file].[column] links on [dataset].[file].[column]. Uses Markdown for styling.
preparation
string
It contains an unordered list of all changes made in the preparatory file described in the parent section according to Directory-006 (Dataset preparation). Uses Markdown for styling.
changes
string
It contains an unordered list of all changes made in the data after integration of the file described in the parent section into the EUPH according to Directory-006 (Dataset preparation). Uses Markdown for styling.
unresolved
string
It contains an unordered list of all unresolved issues in the file of the parent section requiring intervention by the data provider according to Directory-007 (Data profiling). Uses Markdown for styling.
created_at
string
The date and time the table was created.
updated_at
string
The date and time the table was last updated.
id
integer
Numeric identifier of the table.
descriptors
string[]
An array of all descriptors, used to integrate this dataset. Field is hidden for non-public datasets.
*
object
uid
string
The unique identifier used to identify the descriptor within the platform.
namespace
string|null
The namespace this descriptor belongs to.
name
string
Name of the descriptor.
description
string|null
A short, concise description of the descriptor. If a class is assigned to descriptor, this field contains the accepted definition of the related class. Uses Markdown for styling.
notes
string|null
Any additional notes attached to the descriptor. Uses Markdown for styling.
examples
string|null
A list of examples, how the data may appear. Uses Markdown for styling.
class
string|null
An optional class, related to this descriptor.
unit
string|null
The unit data is saved in. May not be set.
deprecated
boolean
Whether this descriptor is deprecated or not. Deprecated descriptors can not be used to import new data.
created_at
string
The date and time the table was created.
updated_at
string
The date and time the table was last updated.
published_at
string|null
The date and time the dataset was published.
created_at
string
The date and time the dataset was created.
updated_at
string
The date and time the dataset was last updated.
List data
requires authentication
Retrieves data based on dataset table unique identifier.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?limit=3" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'limit' => '3',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0"
);
const params = {
"limit": "3",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0'
params = {
'limit': '3',
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 56
access-control-allow-origin: *
{
"current_page": 1,
"data": [
{
"id": 5144238,
"timestamp": null,
"data": [
{
"descriptor": "0.0.LPHCN4",
"column": "alpha2code",
"column_id": 28,
"value": "AL",
"unit": null
},
{
"descriptor": "NUTSA3.RNITS37.NTSLV41",
"column": "nuts3",
"column_id": 33,
"value": "Qarks",
"unit": null
}
]
},
{
"id": 5144239,
"timestamp": null,
"data": [
{
"descriptor": "0.0.LPHCN4",
"column": "alpha2code",
"column_id": 28,
"value": "AT",
"unit": null
},
{
"descriptor": "NUTSA3.RNITS37.NTSLV37",
"column": "nuts1",
"column_id": 29,
"value": "Gruppen von \nBundesländern",
"unit": null
},
{
"descriptor": "NUTSA3.RNITS37.NTSLV39",
"column": "nuts2",
"column_id": 31,
"value": "Bundesländer",
"unit": null
},
{
"descriptor": "NUTSA3.RNITS37.NTSLV41",
"column": "nuts3",
"column_id": 33,
"value": "Gruppen von Gemeinden",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "lau",
"column_id": 35,
"value": "Gemeinden",
"unit": null
}
]
},
{
"id": 5144240,
"timestamp": null,
"data": [
{
"descriptor": "0.0.LPHCN4",
"column": "alpha2code",
"column_id": 28,
"value": "BE",
"unit": null
},
{
"descriptor": "NUTSA3.RNITS37.NTSLV37",
"column": "nuts1",
"column_id": 29,
"value": "Gewesten / \nRégions",
"unit": null
},
{
"descriptor": "NUTSA3.RNITS37.NTSLV39",
"column": "nuts2",
"column_id": 31,
"value": "Provincies / Provinces",
"unit": null
},
{
"descriptor": "NUTSA3.RNITS37.NTSLV41",
"column": "nuts3",
"column_id": 33,
"value": "Arrondisse-menten / Arrondisse-ments",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "lau",
"column_id": 35,
"value": "Gemeenten / Communes",
"unit": null
}
]
}
],
"first_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=1",
"from": 1,
"last_page": 13,
"last_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=13",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=1",
"label": "1",
"active": true
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=2",
"label": "2",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=3",
"label": "3",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=4",
"label": "4",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=5",
"label": "5",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=6",
"label": "6",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=7",
"label": "7",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=8",
"label": "8",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=9",
"label": "9",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=10",
"label": "10",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=11",
"label": "11",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=12",
"label": "12",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=13",
"label": "13",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=2",
"label": "Next »",
"active": false
}
],
"next_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=2",
"path": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0",
"per_page": 3,
"prev_page_url": null,
"to": 3,
"total": 37
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
records
object[]
List of Records.
*
object
id
string
The record id, used to identify it in EUPH database.
timestamp
string
Timestamp this record was recorded at.
data
object[]
List of data contained within the Record.
*
object
column
string
The name of the column, the value was imported from.
column_id
int|null
The internal id of the column.
descriptor
string
The UID of the descriptor this datum represents.
value
The value of the datum.
unit
string|null
The UID of the Unit, this datum is related to. Can be null.
Entities
A group of routes used to manage Entities (Data providers), related to authenticated user.
List Entities
requires authentication
Retrieve a list of all entities authenticated user has access to.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/entities?page=1&limit=3" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'page' => '1',
'limit' => '3',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/entities"
);
const params = {
"page": "1",
"limit": "3",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/entities'
params = {
'page': '1',
'limit': '3',
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 59
access-control-allow-origin: *
{
"current_page": 1,
"data": [
{
"id": 13,
"uid": "boe",
"name": "Biene Österreich – Imkereidachverband",
"type": "person",
"abbreviation": " BÖ",
"created_at": "2023-10-05T10:02:30.000000Z",
"updated_at": "2023-11-21T13:58:41.000000Z"
},
{
"id": 3,
"uid": "euph",
"name": "EU Pollinator Hub",
"type": "legal-entity",
"abbreviation": "EUPH",
"created_at": "2023-10-05T10:02:30.000000Z",
"updated_at": "2024-06-04T12:59:02.000000Z"
},
{
"id": 14,
"uid": "efsa",
"name": "European Food Safety Authority",
"type": "person",
"abbreviation": "EFSA",
"created_at": "2023-10-05T10:02:30.000000Z",
"updated_at": "2023-10-26T17:37:58.000000Z"
}
],
"first_page_url": "https://app.pollinatorhub.eu/api/v1/entities?page=1",
"from": 1,
"last_page": 2,
"last_page_url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/entities?page=1",
"label": "1",
"active": true
},
{
"url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
"label": "2",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
"label": "Next »",
"active": false
}
],
"next_page_url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
"path": "https://app.pollinatorhub.eu/api/v1/entities",
"per_page": 3,
"prev_page_url": null,
"to": 3,
"total": 4
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
string[]
A list of entities available to the User.
*
object
id
integer
Numeric identifier of the entity.
uid
string
The unique identifier used to identify the entity within the platform.
name
string
A descriptive name of the entity.
abbreviation
string
Abbreviation or short name of the entity.
type
string
Type of the Entity. Can be 'person' or 'legal-entity'.
created_at
string
The date and time the entity was created.
updated_at
string
The date and time the entity was last updated.
Create Entity
requires authentication
Create a new entity to be used and interact with.
Example request:
curl --request POST \
"https://app.pollinatorhub.eu/api/v1/entities" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"European Food Safety Authority\",
\"abbreviation\": \"EFSA\",
\"country_id\": \"IT\",
\"type\": \"legal-entity\",
\"contact\": [
{
\"type\": \"email\",
\"value\": \"example@pollinatorhub.eu\"
}
]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities';
$response = $client->post(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'name' => 'European Food Safety Authority',
'abbreviation' => 'EFSA',
'country_id' => 'IT',
'type' => 'legal-entity',
'contact' => [
[
'type' => 'email',
'value' => 'example@pollinatorhub.eu',
],
],
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/entities"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"name": "European Food Safety Authority",
"abbreviation": "EFSA",
"country_id": "IT",
"type": "legal-entity",
"contact": [
{
"type": "email",
"value": "example@pollinatorhub.eu"
}
]
};
fetch(url, {
method: "POST",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/entities'
payload = {
"name": "European Food Safety Authority",
"abbreviation": "EFSA",
"country_id": "IT",
"type": "legal-entity",
"contact": [
{
"type": "email",
"value": "example@pollinatorhub.eu"
}
]
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Show Entity
requires authentication
Displays a single entity based on unique identifier. Only allows viewing entities that the user has access to.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/entities/3" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities/3';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/entities/3"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/entities/3'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 58
access-control-allow-origin: *
{
"data": {
"id": 3,
"uid": "euph",
"name": "EU Pollinator Hub",
"type": "legal-entity",
"abbreviation": "EUPH",
"registry_number": null,
"description": "The EU Pollinator Hub (EUPH) is a data hub related to pollinators, which is provided by the European Food Safety Authority (EFSA).",
"address": null,
"featured_image": "https://app.pollinatorhub.eu/storage/entities/01HZHN8AQYJDJ2SV1Z8X3XS661.jpg",
"contacts": [
{
"type": "url-linkedin",
"value": "https://www.linkedin.com/company/beelife-european-beekeeping-coordination/"
},
{
"type": "url",
"value": "https://pollinatorhub.eu"
}
],
"country": {
"iso-3166:shortLowercaseNameOfCountry": "Belgium",
"full_name": "the Kingdom of Belgium",
"unsd:m49Area": "56",
"iso-3166:alpha-2CountryCode": "BE",
"iso-3166:alpha-3CountryCode": "BEL"
},
"created_at": "2023-10-05T10:02:30.000000Z",
"updated_at": "2024-06-04T12:59:02.000000Z"
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
string[]
A list of entities available to the User.
id
integer
Numeric identifier of the entity.
name
string
A descriptive name of the entity.
uid
string
The unique identifier used to identify the Entity within the platform.
contact
object[]
A list of contact points for the entity.
type
string
The type of the contact.
value
string
The actual value of the contact, for example email address, url or other.
abbreviation
string|null
Abbreviation or short name of the entity.
registry_number
string|null
A public unique identifier used to identify a legal entity. Can be empty for private persons.
description
string|null
A longer description about the entity. Uses Markdown for styling.
address
string|null
Full address of the entity. Can be empty for private persons.
featured_image
string|null
Url to the featured image.
country
object
Country the entity resides in.
full_name
string
Full name of the country.
iso-3166:shortLowercaseNameOfCountry
string
Short name, written in lower case letters, of the country.
unsd:m49Area
string
Numeric code of the country according to ISO-3166 standard.
iso-3166:alpha-2CountryCode
string
A two-letter code that represents a country name, recommended as general purpose code.
iso-3166:alpha-3CountryCode
string
A three-letter code that represents a country name.
type
string
Type of the Entity. Can be 'person' or 'legal-entity'.
created_at
string
The date and time the entity was created.
updated_at
string
The date and time the entity was last updated.
Update Entity
requires authentication
Update entity metadata.
Example request:
curl --request PUT \
"https://app.pollinatorhub.eu/api/v1/entities/beatae" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"European Food Safety Authority\",
\"abbreviation\": \"EFSA\",
\"country_id\": \"IT\",
\"contact\": [
{
\"type\": \"email\",
\"value\": \"example@pollinatorhub.eu\"
}
]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities/beatae';
$response = $client->put(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'name' => 'European Food Safety Authority',
'abbreviation' => 'EFSA',
'country_id' => 'IT',
'contact' => [
[
'type' => 'email',
'value' => 'example@pollinatorhub.eu',
],
],
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/entities/beatae"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"name": "European Food Safety Authority",
"abbreviation": "EFSA",
"country_id": "IT",
"contact": [
{
"type": "email",
"value": "example@pollinatorhub.eu"
}
]
};
fetch(url, {
method: "PUT",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/entities/beatae'
payload = {
"name": "European Food Safety Authority",
"abbreviation": "EFSA",
"country_id": "IT",
"contact": [
{
"type": "email",
"value": "example@pollinatorhub.eu"
}
]
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('PUT', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Delete entity
requires authentication
Delete selected entity. Note, an entity with associated datasets can not be deleted.
Example request:
curl --request DELETE \
"https://app.pollinatorhub.eu/api/v1/entities/ipsa" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities/ipsa';
$response = $client->delete(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/entities/ipsa"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "DELETE",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/entities/ipsa'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('DELETE', url, headers=headers)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Datasets
This route will allow modifications to the meta-data for the Datasets. It includes basic information like name, description and contact information. It is owned by one or more entities. It directly owns one or more Dataset Parts. It is identified by UID which is created during the data entity creation procedure.
List datasets
requires authentication
Display a listing of the Datasets, the User has access to.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/datasets?entity=euph&page=1&limit=3" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'entity' => 'euph',
'page' => '1',
'limit' => '3',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/datasets"
);
const params = {
"entity": "euph",
"page": "1",
"limit": "3",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/datasets'
params = {
'entity': 'euph',
'page': '1',
'limit': '3',
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 57
access-control-allow-origin: *
{
"current_page": 1,
"data": [
{
"id": 6,
"uid": "HNYPR6.0.0",
"name": "Honey production Austria",
"long_name": "Honey production in Austria",
"description": "The dataset contains anonymised total annual honey yields of test colonies from the performance testing scheme of the Austrian honey bee breeding program. The locations of apiaries were aggregated by NUTS level 1 and HPG.",
"featured_image": null,
"status": "publish",
"public": true,
"licence": "CC BY-NC-SA 4.0",
"published_at": "2023-04-16T22:00:00.000000Z",
"created_at": "2023-01-26T18:18:06.000000Z",
"updated_at": "2024-01-25T09:26:57.000000Z"
},
{
"id": 8,
"uid": "BKPNG8.0.0",
"name": "Beekeeping Austria",
"long_name": "Collection of data related to honey bees in Austria.",
"description": "This dataset is a collection of data related to honey bees (*Apis mellifera* L.) in Austria.",
"featured_image": null,
"status": "publish",
"public": true,
"licence": "CC BY-NC-SA 4.0",
"published_at": "2023-11-30T23:00:00.000000Z",
"created_at": "2022-04-27T07:15:00.000000Z",
"updated_at": "2025-04-18T09:26:56.000000Z"
},
{
"id": 14,
"uid": "VTCSS14.0.0",
"name": "Vetcases",
"long_name": "Reports of notifiable diseases reported for Apis mellifera",
"description": "This dataset contains data from various sources on the outbreak of notifiable diseases reported for honey bees (*Apis mellifera*) in Belgium and Austria from 2000 to 2022.",
"featured_image": "https://app.pollinatorhub.eu/storage/providers/01HHF30JC0SSJRQESPPWNJG3F5.png",
"status": "publish",
"public": true,
"licence": "CC BY-NC-SA 4.0",
"published_at": "2023-06-12T22:00:00.000000Z",
"created_at": "2023-02-08T15:11:52.000000Z",
"updated_at": "2025-04-18T09:26:56.000000Z"
}
],
"first_page_url": "https://app.pollinatorhub.eu/api/v1/datasets?page=1",
"from": 1,
"last_page": 14,
"last_page_url": "https://app.pollinatorhub.eu/api/v1/datasets?page=14",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=1",
"label": "1",
"active": true
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=2",
"label": "2",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=3",
"label": "3",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=4",
"label": "4",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=5",
"label": "5",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=6",
"label": "6",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=7",
"label": "7",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=8",
"label": "8",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=9",
"label": "9",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=10",
"label": "10",
"active": false
},
{
"url": null,
"label": "...",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=13",
"label": "13",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=14",
"label": "14",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/datasets?page=2",
"label": "Next »",
"active": false
}
],
"next_page_url": "https://app.pollinatorhub.eu/api/v1/datasets?page=2",
"path": "https://app.pollinatorhub.eu/api/v1/datasets",
"per_page": 3,
"prev_page_url": null,
"to": 3,
"total": 40
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of Datasets available to the User.
*
object
id
integer
Numeric identifier of the dataset.
name
string
The actual name of the dataset.
long_name
string
The long version of the name of the dataset.
uid
string
The unique identifier used to identify the entity within the platform.
description
string
Dataset abstract. Uses Markdown for styling.
featured_image
string|null
URL to uploaded image representing this dataset.
status
string
The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden
public
boolean
1 means that the data of this dataset are public.
licence
string|null
The uid of the licence of this entity.
published_at
string|null
The date and time the dataset was published.
created_at
string
The date and time the dataset was created.
updated_at
string
The date and time the dataset was last updated. /
Create dataset
requires authentication
Example request:
curl --request POST \
"https://app.pollinatorhub.eu/api/v1/datasets" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"ISO 3166-1:2020\",
\"description\": \"Enim aut perspiciatis minima enim vel.\",
\"data_overview\": \"umrzparbpegdxn\",
\"data_value\": \"dkknduhisnffylnaco\",
\"data_description\": \"lskqzextfyokkzhlfmqjctxm\",
\"data_application\": \"hjfutujrlvtlaoalmqs\",
\"data_issues\": \"wodlvdcomybthoitba\",
\"introduction\": \"qldvxqpelinrwfys\",
\"acquisition\": \"gphjxrinfpkogbssjujzwrvm\",
\"preparation\": \"cdpkednfmcf\",
\"validation\": \"lppfhysfchwawezreeqtdk\",
\"analysis\": \"eexnjbvevjlxgkqqhljzlnog\",
\"licence\": \"cc-by\",
\"entities\": [
\"euph\"
],
\"public\": true,
\"published_at\": \"2023-07-04T11:24:58.000000Z\",
\"contacts\": [
{
\"type\": \"url-vimeo\",
\"value\": \"soktudwrbdvtoucjisstwpkjmxathtpenjvc\"
}
]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets';
$response = $client->post(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'name' => 'ISO 3166-1:2020',
'description' => 'Enim aut perspiciatis minima enim vel.',
'data_overview' => 'umrzparbpegdxn',
'data_value' => 'dkknduhisnffylnaco',
'data_description' => 'lskqzextfyokkzhlfmqjctxm',
'data_application' => 'hjfutujrlvtlaoalmqs',
'data_issues' => 'wodlvdcomybthoitba',
'introduction' => 'qldvxqpelinrwfys',
'acquisition' => 'gphjxrinfpkogbssjujzwrvm',
'preparation' => 'cdpkednfmcf',
'validation' => 'lppfhysfchwawezreeqtdk',
'analysis' => 'eexnjbvevjlxgkqqhljzlnog',
'licence' => 'cc-by',
'entities' => [
'euph',
],
'public' => true,
'published_at' => '2023-07-04T11:24:58.000000Z',
'contacts' => [
[
'type' => 'url-vimeo',
'value' => 'soktudwrbdvtoucjisstwpkjmxathtpenjvc',
],
],
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/datasets"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"name": "ISO 3166-1:2020",
"description": "Enim aut perspiciatis minima enim vel.",
"data_overview": "umrzparbpegdxn",
"data_value": "dkknduhisnffylnaco",
"data_description": "lskqzextfyokkzhlfmqjctxm",
"data_application": "hjfutujrlvtlaoalmqs",
"data_issues": "wodlvdcomybthoitba",
"introduction": "qldvxqpelinrwfys",
"acquisition": "gphjxrinfpkogbssjujzwrvm",
"preparation": "cdpkednfmcf",
"validation": "lppfhysfchwawezreeqtdk",
"analysis": "eexnjbvevjlxgkqqhljzlnog",
"licence": "cc-by",
"entities": [
"euph"
],
"public": true,
"published_at": "2023-07-04T11:24:58.000000Z",
"contacts": [
{
"type": "url-vimeo",
"value": "soktudwrbdvtoucjisstwpkjmxathtpenjvc"
}
]
};
fetch(url, {
method: "POST",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/datasets'
payload = {
"name": "ISO 3166-1:2020",
"description": "Enim aut perspiciatis minima enim vel.",
"data_overview": "umrzparbpegdxn",
"data_value": "dkknduhisnffylnaco",
"data_description": "lskqzextfyokkzhlfmqjctxm",
"data_application": "hjfutujrlvtlaoalmqs",
"data_issues": "wodlvdcomybthoitba",
"introduction": "qldvxqpelinrwfys",
"acquisition": "gphjxrinfpkogbssjujzwrvm",
"preparation": "cdpkednfmcf",
"validation": "lppfhysfchwawezreeqtdk",
"analysis": "eexnjbvevjlxgkqqhljzlnog",
"licence": "cc-by",
"entities": [
"euph"
],
"public": true,
"published_at": "2023-07-04T11:24:58.000000Z",
"contacts": [
{
"type": "url-vimeo",
"value": "soktudwrbdvtoucjisstwpkjmxathtpenjvc"
}
]
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Show dataset
requires authentication
Display the specified Dataset based on provided unique identifier.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/datasets/4" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/4';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/datasets/4"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/datasets/4'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 56
access-control-allow-origin: *
{
"data": {
"id": 4,
"uid": "PSTCD4.0.0",
"name": "Postcode",
"long_name": "Postcodes from various countries",
"description": "The dataset contains postcodes from 97 countries for internal use on the EUPH.",
"featured_image": null,
"data_overview": null,
"data_value": null,
"data_description": null,
"data_application": null,
"data_issues": null,
"introduction": null,
"acquisition": null,
"preparation": null,
"validation": null,
"analysis": null,
"status": "publish",
"public": false,
"licence": {
"uid": "cc-by-4-0",
"name": "CC BY 4.0",
"abbreviation": "CC BY 4.0",
"description": "### You are free to:\n\n* Share — copy and redistribute the material in any medium or format for any purpose, even commercially.\n* Adapt — remix, transform, and build upon the material for any purpose, even commercially.\n* The licensor cannot revoke these freedoms as long as you follow the license terms.\n\n### Under the following terms:\n\n* Attribution - You must give appropriate credit , provide a link to the license, and indicate if changes were made . You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.\n* No additional restrictions - You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.\n\n### Notices:\n\nYou do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.\n\nNo warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.\n",
"url_summary": "https://creativecommons.org/licenses/by/4.0/",
"url_legal": "https://creativecommons.org/licenses/by/4.0/legalcode",
"image_url": "/storage/01HF961C5YQASH3TQ6MNYKN9WN.svg"
},
"contacts": [],
"entities": [
{
"id": 3,
"uid": "euph",
"name": "EU Pollinator Hub",
"type": "legal-entity",
"abbreviation": "EUPH",
"created_at": "2023-10-05T10:02:30.000000Z",
"updated_at": "2024-06-04T12:59:02.000000Z"
}
],
"contributors": [],
"parts": [
{
"id": 72,
"uid": "PSTCD4.WRLDW72.0",
"name": "Worldwide postcodes",
"description": "The table contains postcodes from 97 countries.",
"featured_image": null,
"type": "file",
"licence": "cc-by-4-0",
"created_at": "2023-10-05T07:59:13.000000Z",
"updated_at": "2024-01-25T09:26:57.000000Z"
}
],
"descriptors": [],
"published_at": "2023-09-12T22:00:00.000000Z",
"created_at": "2023-01-26T18:18:06.000000Z",
"updated_at": "2024-01-26T19:17:49.000000Z"
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of metadata associated with the requested dataset.
id
integer
Numeric identifier of the dataset.
uid
string
The unique identifier used to identify the entity within the platform.
name
string
The actual name of the dataset.
long_name
string
The long version of the name of the dataset.
description
string
Abstract about the dataset. Uses Markdown for styling.
featured_image
string|null
URL to uploaded image representing this dataset.
data_overview
string
Concise information (less than 200 words) about: e.g. provider of the data (who?); origin of the data and the subject area covered by the dataset (what?); geographical origin of the data (where?); time period covered by the dataset (when?). Uses Markdown for styling.
data_value
string
Concise information (less than 200 words) about: e.g. reason for collecting the data; possible benefits resulting from the collection of the data (why?). Uses Markdown for styling.
data_description
string
Concise description (less than 200 words) of the dataset metrics: e.g. number of files; categories of data; size of the datasets in bytes. Uses Markdown for styling.
data_application
string
A concise summary (less than 200 words) of possible applications for which the data could be used, scientific or technical questions or other issues that could be addressed (for what?). Uses Markdown for styling.
data_issues
string
A list of unresolved issues and quality concerns. Uses Markdown for styling.
introduction
string
A longer description about the dataset. Uses Markdown for styling.
acquisition
string
Description of or a reference to material and methods used to acquire the data in the dataset and a detailed list of terms under which the data has been made available (licensing).Uses Markdown for styling.
preparation
string
Detailed description of material (product, model) and methods (provide references if possible) used to prepare the dataset. Uses Markdown for styling.
validation
string
Detailed description of material (product, model) and methods (provide references if possible) used to validate the dataset for the purpose of data quality assessment. Uses Markdown for styling.
analysis
string
Detailed description of material (product, model) and methods (provide references if possible) used to analyse the dataset for the purpose of data quality assessment. Uses Markdown for styling.
status
string
The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden
public
boolean
Value of 1 means that the data of this dataset are publicly accessible.
licence
array|null The licence information of this entity.
name
string
The name of the licence.
abbreviation
string
The short name of the licence.
description
string
The description of the licence.
uid
string
The unique identifier of the licence.
url_summary
string|null
Url to external description of this licence.
url_legal
string|null
Url to external legal definition of this licence.
image_url
string|null
Url to licence image representation.
contact
object[]
A list of contact points for the entity.
type
string
The type of the contact.
value
string
The actual value of the contact, for
entities
string[]
Array containing the uid of the entities of this dataset.
*
string
The Uid of the entity.
contributors
string[]
Array containing the uid of the contributors of this dataset.
*
string
The Uid of the contributor.
parts
string[]
An array containing all related dataset tables. Field is hidden for non-public datasets.
*
object
uid
string
The unique identifier used to identify the table within the platform.
name
string
Name of the table.
description
string
Description of the table. Uses Markdown for styling.
structure
string
An unordered list of potential links between columns of the same file, of different files of the same dataset or of different files of different datasets as follows: Column [dataset].[file].[column] links on [dataset].[file].[column]. Uses Markdown for styling.
preparation
string
It contains an unordered list of all changes made in the preparatory file described in the parent section according to Directory-006 (Dataset preparation). Uses Markdown for styling.
changes
string
It contains an unordered list of all changes made in the data after integration of the file described in the parent section into the EUPH according to Directory-006 (Dataset preparation). Uses Markdown for styling.
unresolved
string
It contains an unordered list of all unresolved issues in the file of the parent section requiring intervention by the data provider according to Directory-007 (Data profiling). Uses Markdown for styling.
created_at
string
The date and time the table was created.
updated_at
string
The date and time the table was last updated.
id
integer
Numeric identifier of the table.
descriptors
string[]
An array of all descriptors, used to integrate this dataset. Field is hidden for non-public datasets.
*
object
uid
string
The unique identifier used to identify the descriptor within the platform.
namespace
string|null
The namespace this descriptor belongs to.
name
string
Name of the descriptor.
description
string|null
A short, concise description of the descriptor. If a class is assigned to descriptor, this field contains the accepted definition of the related class. Uses Markdown for styling.
notes
string|null
Any additional notes attached to the descriptor. Uses Markdown for styling.
examples
string|null
A list of examples, how the data may appear. Uses Markdown for styling.
class
string|null
An optional class, related to this descriptor.
unit
string|null
The unit data is saved in. May not be set.
deprecated
boolean
Whether this descriptor is deprecated or not. Deprecated descriptors can not be used to import new data.
created_at
string
The date and time the table was created.
updated_at
string
The date and time the table was last updated.
published_at
string|null
The date and time the dataset was published.
created_at
string
The date and time the dataset was created.
updated_at
string
The date and time the dataset was last updated.
Update dataset
requires authentication
Example request:
curl --request PUT \
"https://app.pollinatorhub.eu/api/v1/datasets/1" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"entities\": [
\"euph\"
],
\"name\": \"ISO 3166-1:2020\",
\"long_name\": \"No-example\",
\"description\": \"Ea maxime eligendi rerum laborum eos.\",
\"data_overview\": \"joeeyfwiqo\",
\"data_value\": \"azvzqipwarjsecae\",
\"data_description\": \"bpuermdwpiqveblwnz\",
\"data_application\": \"xmgafqvbnuibamtyvalhzj\",
\"data_issues\": \"qhzjgscbvhnwkczswgxnibnl\",
\"introduction\": \"vgzvkmnxxoihsk\",
\"acquisition\": \"tmlbqlofmgr\",
\"preparation\": \"wbi\",
\"validation\": \"ngjbmekkznhdwgvngwezo\",
\"analysis\": \"lwknuhcdotq\",
\"licence\": \"cc-by\",
\"public\": true,
\"published_at\": \"2023-07-04T11:24:58.000000Z\"
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/1';
$response = $client->put(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'entities' => [
'euph',
],
'name' => 'ISO 3166-1:2020',
'long_name' => 'No-example',
'description' => 'Ea maxime eligendi rerum laborum eos.',
'data_overview' => 'joeeyfwiqo',
'data_value' => 'azvzqipwarjsecae',
'data_description' => 'bpuermdwpiqveblwnz',
'data_application' => 'xmgafqvbnuibamtyvalhzj',
'data_issues' => 'qhzjgscbvhnwkczswgxnibnl',
'introduction' => 'vgzvkmnxxoihsk',
'acquisition' => 'tmlbqlofmgr',
'preparation' => 'wbi',
'validation' => 'ngjbmekkznhdwgvngwezo',
'analysis' => 'lwknuhcdotq',
'licence' => 'cc-by',
'public' => true,
'published_at' => '2023-07-04T11:24:58.000000Z',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/datasets/1"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"entities": [
"euph"
],
"name": "ISO 3166-1:2020",
"long_name": "No-example",
"description": "Ea maxime eligendi rerum laborum eos.",
"data_overview": "joeeyfwiqo",
"data_value": "azvzqipwarjsecae",
"data_description": "bpuermdwpiqveblwnz",
"data_application": "xmgafqvbnuibamtyvalhzj",
"data_issues": "qhzjgscbvhnwkczswgxnibnl",
"introduction": "vgzvkmnxxoihsk",
"acquisition": "tmlbqlofmgr",
"preparation": "wbi",
"validation": "ngjbmekkznhdwgvngwezo",
"analysis": "lwknuhcdotq",
"licence": "cc-by",
"public": true,
"published_at": "2023-07-04T11:24:58.000000Z"
};
fetch(url, {
method: "PUT",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/datasets/1'
payload = {
"entities": [
"euph"
],
"name": "ISO 3166-1:2020",
"long_name": "No-example",
"description": "Ea maxime eligendi rerum laborum eos.",
"data_overview": "joeeyfwiqo",
"data_value": "azvzqipwarjsecae",
"data_description": "bpuermdwpiqveblwnz",
"data_application": "xmgafqvbnuibamtyvalhzj",
"data_issues": "qhzjgscbvhnwkczswgxnibnl",
"introduction": "vgzvkmnxxoihsk",
"acquisition": "tmlbqlofmgr",
"preparation": "wbi",
"validation": "ngjbmekkznhdwgvngwezo",
"analysis": "lwknuhcdotq",
"licence": "cc-by",
"public": true,
"published_at": "2023-07-04T11:24:58.000000Z"
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('PUT', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Delete dataset
requires authentication
<aside class"warning">Only dataset without any tables can be deleted.
Example request:
curl --request DELETE \
"https://app.pollinatorhub.eu/api/v1/datasets/1" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/1';
$response = $client->delete(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/datasets/1"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "DELETE",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/datasets/1'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('DELETE', url, headers=headers)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Tables
Routes used to manage Dataset Tables.
List tables
requires authentication
Display a list of all tables of the supplied dataset.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/datasets/2/parts" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/datasets/2/parts"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers)
response.json()
Example response (200):
{
"data": [
{
"name": "ISO 3166-1:2020",
"description": "File iso3166_1_2020.csv contains 291 records of countries included in the ISO standard 3166-1:2020...",
"uid": "DTST1.PRTA1.0",
"type": "file",
"licence_id": "unlicenced",
"created_at": "2023-07-04T11:24:58.000000Z",
"updated_at": "2023-07-04T11:24:58.000000Z"
}
]
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of dataset tables available to the User.
*
object
id
integer
Numeric identifier of the table.
uid
string
The unique identifier used to identify the table within the platform.
name
string
The title of the table.
description
string|null
Detailed description of the table.
featured_image
string|null
URL to uploaded image representing this table.
type
string
The type of this table.
licence
string|null
The licence defined specifically for this table.
created_at
string
The date and time it was created.
updated_at
string
The date and time it was last updated.
Create table
requires authentication
Create and attach a new table to the supplied dataset.
Example request:
curl --request POST \
"https://app.pollinatorhub.eu/api/v1/datasets/2/parts" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"ISO 3166-1:2020\",
\"type\": \"api\"
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts';
$response = $client->post(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'name' => 'ISO 3166-1:2020',
'type' => 'api',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/datasets/2/parts"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"name": "ISO 3166-1:2020",
"type": "api"
};
fetch(url, {
method: "POST",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts'
payload = {
"name": "ISO 3166-1:2020",
"type": "api"
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Show table
requires authentication
Retrieve metadata for a single table within a dataset.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/parts/5" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/5';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/5"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/5'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 55
access-control-allow-origin: *
{
"data": {
"id": 5,
"uid": "UNSDA25.NCMTR5.0",
"name": "Un Comtrade Units",
"description": "This table contains quantity units used in detailed UN Comtrade data, based on the standards of quantity recommended by the World Customs Organization (WCO).",
"featured_image": null,
"structure": null,
"preparation": "None",
"changes": "None",
"unresolved": "None",
"additional_information": null,
"type": "file",
"licence": "euph",
"columns": [
{
"id": 1882,
"name": "UnsdId",
"description": null,
"descriptor": {
"id": 849,
"uid": "0.0.NSDNT849",
"namespace": "unsd",
"name": "unsdUnitID",
"description": "Special units maintained by the [United Nations Statistics Division (UNSD)](https://app.pollinatorhub.eu/vocabulary/classes/7822)).",
"class": "[EUPH-code: 8037]",
"unit": null,
"created_at": "2025-02-12T17:44:44.000000Z",
"updated_at": "2025-02-14T11:53:11.000000Z"
},
"unit": null,
"datatype": {
"label": "Integer",
"priority": 10
},
"order": 0,
"created_at": "2024-01-26T18:44:26.000000Z",
"updated_at": "2025-02-14T11:53:52.000000Z"
},
{
"id": 1883,
"name": "WCOAbbreviation",
"description": null,
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": {
"label": "String",
"priority": 100
},
"order": 0,
"created_at": "2024-01-26T18:44:26.000000Z",
"updated_at": "2025-02-14T11:53:52.000000Z"
},
{
"id": 1884,
"name": "Description",
"description": null,
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": {
"label": "String",
"priority": 100
},
"order": 0,
"created_at": "2024-01-26T18:44:26.000000Z",
"updated_at": "2025-02-14T11:53:52.000000Z"
}
],
"data_files": [
{
"id": 886,
"name": "euph_000025_unsd_table_uncomtradeunits.csv",
"description": null,
"status": "analyzed",
"type": "csv",
"mimetype": "text/csv",
"file_size": 483,
"download_count": 0,
"created_at": "2025-02-14T11:32:07.000000Z",
"updated_at": "2025-02-14T11:35:06.000000Z"
}
],
"supplemental_files": [],
"created_at": "2023-02-04T14:56:12.000000Z",
"updated_at": "2025-04-18T09:26:56.000000Z"
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of metadata associated with the requested dataset table.
id
integer
Numeric identifier of the table.
uid
string
The unique identifier used to identify the table within the platform.
name
string
The title of the table.
description
string|null
Detailed description of the table.
featured_image
string|null
URL to uploaded image representing this table.
structure
string|null
An unordered list of potential links between columns of the same file, of different files of the same dataset or of different files of different datasets as follows: Column [dataset].[file].[column] links on [dataset].[file].[column].
preparation
string|null
It contains an unordered list of all changes made in the preparatory file described in the parent section according to Directory-006 (Dataset preparation).
changes
string|null
It contains an unordered list of all changes made in the data after integration of the file described in the parent section into the EUPH according to Directory-006 (Dataset preparation).
unresolved
string|null
It contains an unordered list of all unresolved issues in the file of the parent section requiring intervention by the data provider according to Directory-007 (Data profiling).
type
string
The type of this table.
additional_information
string|null
Any additional information required to acquire this table data.
licence
string|null
The licence defined specifically for this table.
columns
string[]
A list of associated columns with this table.
*
object
id
integer
Numeric identifier of the column.
name
string
The title of the column.
description
string|null
Detailed description of the column.
descriptor
string[]
The descriptor used to internally represent the data.
id
integer
Numeric identifier of the descriptor.
uid
string
The unique identifier used to identify the descriptor within the platform.
namespace
string|null
The namespace this descriptor conforms to.
name
string
The title of the descriptor.
description
string|null
Detailed description of the descriptor.
class
string|null
The class this descriptor is described by.
unit
array|null The unit the data of this descriptor is saved in.
datatype
string[]
The datatype this column saves data in.
label
string
The label of the datatype.
priority
integer
The priority ranking of this datatype.
order
integer
The order of this column, that it appears in the table.
created_at
string
The date and time it was created.
updated_at
string
The date and time it was last updated.
data_files
string[]
A list of uploaded data files.
*
object
id
integer
Numeric identifier of the uploaded file.
name
string
The original filename.
description
string|null
status
string
The internal status of this file.
type
string
Identified type of this file.
mimetype
string
Identified mimetype of this file.
file_size
integer
The filesize in bytes.
download_count
intNumber of times this file was downloaded.
created_at
string
The date and time it was created.
updated_at
string
The date and time it was last updated.
supplemental_files
string[]
A list of uploaded data files.
*
object
id
integer
Numeric identifier of the uploaded file.
name
string
The original filename.
description
string|null
status
string
The internal status of this file.
type
string
Identified type of this file.
mimetype
stringIdentified mimetype of this file.
file_size
intThe filesize in bytes.
download_count
integer
Number of times this file was downloaded.
created_at
string
The date and time it was created.
updated_at
string
The date and time it was last updated.
created_at
string
The date and time it was created.
updated_at
string
The date and time it was last updated.
Update table
requires authentication
Update table metadata with new values.
Example request:
curl --request PUT \
"https://app.pollinatorhub.eu/api/v1/parts/1" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"ISO 3166-1:2020\",
\"description\": \"No-example\",
\"type\": \"api\"
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1';
$response = $client->put(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'name' => 'ISO 3166-1:2020',
'description' => 'No-example',
'type' => 'api',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/1"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"name": "ISO 3166-1:2020",
"description": "No-example",
"type": "api"
};
fetch(url, {
method: "PUT",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/1'
payload = {
"name": "ISO 3166-1:2020",
"description": "No-example",
"type": "api"
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('PUT', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Delete table.
requires authentication
Delete a single table. <aside class"warning">Only table with no uploaded data can be deleted.
Example request:
curl --request DELETE \
"https://app.pollinatorhub.eu/api/v1/parts/1" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1';
$response = $client->delete(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/1"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "DELETE",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/1'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('DELETE', url, headers=headers)
response.json()
Example response (202):
{}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Columns
This route will allow modifications to the meta-data for individual columns of a dataset. It includes basic information like name, description and descriptor information. It is owned by one or more entities. It is identified by numeric ID which is created during creation procedure.
List columns
requires authentication
Display a listing of the Datasets, the User has access to.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/parts/1/columns?entity=euph&page=1&limit=3" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'entity' => 'euph',
'page' => '1',
'limit' => '3',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/1/columns"
);
const params = {
"entity": "euph",
"page": "1",
"limit": "3",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns'
params = {
'entity': 'euph',
'page': '1',
'limit': '3',
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 54
access-control-allow-origin: *
{
"current_page": 1,
"data": [
{
"id": 1,
"name": "CountryId",
"description": null,
"descriptor": {
"id": 344,
"uid": "0.0.RCRDD344",
"namespace": "pms",
"name": "recordID",
"description": "Unique sequence of integers associated with a record within a certain table.",
"class": "[EUPH-code: 3331]",
"unit": null,
"created_at": "2023-11-26T12:08:55.000000Z",
"updated_at": "2025-02-06T15:51:38.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-09-01T08:53:37.000000Z",
"updated_at": "2025-02-12T13:19:21.000000Z"
},
{
"id": 2,
"name": "NumericCode",
"description": null,
"descriptor": {
"id": 519,
"uid": "0.0.MAREA519",
"namespace": "unsd",
"name": "m49Area",
"description": "Name of the countries or areas or geographic regions in the [M49 standard](https://app.pollinatorhub.eu/vocabulary/classes/7292) used for statistical processing purposes by the [Statistics Division of the United Nations Secretariat](https://unstats.un.org).",
"class": "[EUPH-code: 7441]",
"unit": null,
"created_at": "2024-11-22T15:54:40.000000Z",
"updated_at": "2025-02-06T12:33:33.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-09-01T08:53:37.000000Z",
"updated_at": "2025-02-12T13:12:03.000000Z"
},
{
"id": 3,
"name": "FullName",
"description": "Full name of the country, as recorded in [UNTERM](https://unterm.un.org).",
"descriptor": {
"id": 315,
"uid": "0.0.TEXTA315",
"namespace": null,
"name": "Text",
"description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
"class": "[EUPH-code: 7322]",
"unit": null,
"created_at": null,
"updated_at": "2024-09-14T11:17:02.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-09-01T08:53:37.000000Z",
"updated_at": "2025-02-12T13:12:03.000000Z"
}
],
"first_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=1",
"from": 1,
"last_page": 5,
"last_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=5",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=1",
"label": "1",
"active": true
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=2",
"label": "2",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=3",
"label": "3",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=4",
"label": "4",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=5",
"label": "5",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=2",
"label": "Next »",
"active": false
}
],
"next_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=2",
"path": "https://app.pollinatorhub.eu/api/v1/parts/1/columns",
"per_page": 3,
"prev_page_url": null,
"to": 3,
"total": 15
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of Datasets available to the User.
*
object
id
integer
Numeric identifier of the dataset.
name
string
The actual name of the dataset.
long_name
string
The long version of the name of the dataset.
uid
string
The unique identifier used to identify the entity within the platform.
description
string
Dataset abstract. Uses Markdown for styling.
featured_image
string|null
URL to uploaded image representing this dataset.
status
string
The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden
public
boolean
1 means that the data of this dataset are public.
licence
string|null
The uid of the licence of this entity.
published_at
string|null
The date and time the dataset was published.
created_at
string
The date and time the dataset was created.
updated_at
string
The date and time the dataset was last updated.
Create column
requires authentication
Example request:
curl --request POST \
"https://app.pollinatorhub.eu/api/v1/parts/1/columns" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"Hive scale weight\",
\"descriptor\": \"0.0.LPHCN4\",
\"datatype\": \"String, Integer, Decimal, Date, Time, DateTime, Boolean\",
\"order\": 1
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns';
$response = $client->post(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'name' => 'Hive scale weight',
'descriptor' => '0.0.LPHCN4',
'datatype' => 'String, Integer, Decimal, Date, Time, DateTime, Boolean',
'order' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/1/columns"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"name": "Hive scale weight",
"descriptor": "0.0.LPHCN4",
"datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
"order": 1
};
fetch(url, {
method: "POST",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns'
payload = {
"name": "Hive scale weight",
"descriptor": "0.0.LPHCN4",
"datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
"order": 1
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Show column
requires authentication
Display the specified dataset table column based on provided numeric identifier.
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/columns/4" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/columns/4';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/columns/4"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/columns/4'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 53
access-control-allow-origin: *
{
"data": {
"id": 4,
"name": "ShortName",
"description": null,
"descriptor": {
"id": 3,
"uid": "0.0.SHRTC3",
"namespace": "iso-3166",
"name": "shortUppercaseNameOfCountry",
"description": "> [...] Short form of the country name [in capital letters], distinctive word first. [...] In [language of the ISO 3166 standard](https://app.pollinatorhub.eu/vocabulary/classes/7930). [...] This item might be inverted, allowing the distinctive word to appear first, so that items can be easily found in an alphabetical list. See [Annex F]https://www.iso.org/obp/ui/en/#iso:std:iso:3166:-1:ed-4:v1:en:sec:F), principles [F.2](https://www.iso.org/obp/ui/en/#iso:std:iso:3166:-1:ed-4:v1:en:sec:F.2).",
"class": "[EUPH-code: 7929]",
"unit": null,
"created_at": "2022-11-19T09:03:29.000000Z",
"updated_at": "2025-02-12T11:56:33.000000Z"
},
"unit": null,
"datatype": null,
"order": 0,
"created_at": "2023-09-01T08:53:37.000000Z",
"updated_at": "2025-02-12T13:12:03.000000Z"
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
data
object[]
A list of metadata associated with the requested dataset.
id
integer
Numeric identifier of the dataset.
uid
string
The unique identifier used to identify the entity within the platform.
name
string
The actual name of the dataset.
created_at
string
The date and time the dataset was created.
updated_at
string
The date and time the dataset was last updated.
Update column
requires authentication
Example request:
curl --request PUT \
"https://app.pollinatorhub.eu/api/v1/columns/1" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"Hive scale weight\",
\"descriptor\": \"0.0.LPHCN4\",
\"datatype\": \"String, Integer, Decimal, Date, Time, DateTime, Boolean\",
\"order\": 1
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/columns/1';
$response = $client->put(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'name' => 'Hive scale weight',
'descriptor' => '0.0.LPHCN4',
'datatype' => 'String, Integer, Decimal, Date, Time, DateTime, Boolean',
'order' => 1,
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/columns/1"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"name": "Hive scale weight",
"descriptor": "0.0.LPHCN4",
"datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
"order": 1
};
fetch(url, {
method: "PUT",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/columns/1'
payload = {
"name": "Hive scale weight",
"descriptor": "0.0.LPHCN4",
"datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
"order": 1
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('PUT', url, headers=headers, json=payload)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Delete column
requires authentication
Example request:
curl --request DELETE \
"https://app.pollinatorhub.eu/api/v1/columns/1" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/columns/1';
$response = $client->delete(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/columns/1"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "DELETE",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/columns/1'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('DELETE', url, headers=headers)
response.json()
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Data
APIs for managing data records and values.
List Data
requires authentication
Display a listing of all data related to this Dataset Part. Is paginated..
Example request:
curl --request GET \
--get "https://app.pollinatorhub.eu/api/v1/parts/1/data?limit=3" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data';
$response = $client->get(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'limit' => '3',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/1/data"
);
const params = {
"limit": "3",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data'
params = {
'limit': '3',
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('GET', url, headers=headers, params=params)
response.json()
Example response (200):
Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 52
access-control-allow-origin: *
{
"current_page": 1,
"data": [
{
"id": 1,
"timestamp": "2020",
"data": [
{
"descriptor": "0.0.SHRTC3",
"column": "ShortName",
"column_id": 4,
"value": "ANTARCTICA",
"unit": null
},
{
"descriptor": "0.0.LPHCN4",
"column": "Alpha2Code",
"column_id": 6,
"value": "AQ",
"unit": null
},
{
"descriptor": "0.0.LPHCN5",
"column": "Alpha3Code",
"column_id": 7,
"value": "ATA",
"unit": null
},
{
"descriptor": "0.0.SHRTC10",
"column": "ShortNameLcEn",
"column_id": 5,
"value": "Antarctica",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "Status",
"column_id": 11,
"value": "Officially assigned",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "AnnotationP1En",
"column_id": 13,
"value": "Territories south of 60° south latitude.",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "AnnotationP2En",
"column_id": 14,
"value": "No subdivisions relevant for this standard.",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "AnnotationP3En",
"column_id": 15,
"value": "French Southern and Antarctic Territories (FQ, ATF, --) are now part of Antarctica and French Southern Territories (TF, ATF, 260). See also code element FQHH. Dronning Maud Land (NQ, ATN, 216) is now part of Antarctica. See also code element NQAQ.",
"unit": null
},
{
"descriptor": "0.0.RCRDD344",
"column": "CountryId",
"column_id": 1,
"value": "1",
"unit": null
},
{
"descriptor": "0.0.MAREA519",
"column": "NumericCode",
"column_id": 2,
"value": "10",
"unit": null
}
]
},
{
"id": 2,
"timestamp": "2020",
"data": [
{
"descriptor": "0.0.SHRTC3",
"column": "ShortName",
"column_id": 4,
"value": "BULGARIA",
"unit": null
},
{
"descriptor": "0.0.LPHCN4",
"column": "Alpha2Code",
"column_id": 6,
"value": "BG",
"unit": null
},
{
"descriptor": "0.0.LPHCN5",
"column": "Alpha3Code",
"column_id": 7,
"value": "BGR",
"unit": null
},
{
"descriptor": "0.0.SHRTC10",
"column": "ShortNameLcEn",
"column_id": 5,
"value": "Bulgaria",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "Status",
"column_id": 11,
"value": "Officially assigned",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "FullName",
"column_id": 3,
"value": "the Republic of Bulgaria",
"unit": null
},
{
"descriptor": "0.0.RCRDD344",
"column": "CountryId",
"column_id": 1,
"value": "2",
"unit": null
},
{
"descriptor": "0.0.MAREA519",
"column": "NumericCode",
"column_id": 2,
"value": "100",
"unit": null
}
]
},
{
"id": 3,
"timestamp": "2020",
"data": [
{
"descriptor": "0.0.SHRTC3",
"column": "ShortName",
"column_id": 4,
"value": "MYANMAR",
"unit": null
},
{
"descriptor": "0.0.LPHCN4",
"column": "Alpha2Code",
"column_id": 6,
"value": "MM",
"unit": null
},
{
"descriptor": "0.0.LPHCN5",
"column": "Alpha3Code",
"column_id": 7,
"value": "MMR",
"unit": null
},
{
"descriptor": "0.0.SHRTC10",
"column": "ShortNameLcEn",
"column_id": 5,
"value": "Myanmar",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "Status",
"column_id": 11,
"value": "Officially assigned",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "FullName",
"column_id": 3,
"value": "the Republic of the Union of Myanmar",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "AnnotationP2En",
"column_id": 14,
"value": "Remark: the forms used in the list are English-language forms provided by Myanmar.",
"unit": null
},
{
"descriptor": "0.0.TEXTA315",
"column": "AnnotationP3En",
"column_id": 15,
"value": "Name changed from former Burma (BU, BUR, 104) to Myanmar (MM MMR, 104). See code element BUMM.",
"unit": null
},
{
"descriptor": "0.0.RCRDD344",
"column": "CountryId",
"column_id": 1,
"value": "3",
"unit": null
},
{
"descriptor": "0.0.MAREA519",
"column": "NumericCode",
"column_id": 2,
"value": "104",
"unit": null
}
]
}
],
"first_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=1",
"from": 1,
"last_page": 97,
"last_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=97",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=1",
"label": "1",
"active": true
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=2",
"label": "2",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=3",
"label": "3",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=4",
"label": "4",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=5",
"label": "5",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=6",
"label": "6",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=7",
"label": "7",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=8",
"label": "8",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=9",
"label": "9",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=10",
"label": "10",
"active": false
},
{
"url": null,
"label": "...",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=96",
"label": "96",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=97",
"label": "97",
"active": false
},
{
"url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=2",
"label": "Next »",
"active": false
}
],
"next_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=2",
"path": "https://app.pollinatorhub.eu/api/v1/parts/1/data",
"per_page": 3,
"prev_page_url": null,
"to": 3,
"total": 291
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Response
Response Fields
records
object[]
List of Records.
*
object
id
integer
The record ID.
timestamp
string
Timestamp this record was recorded at.
data
object[]
List of data contained within the Record.
*
object
descriptor
string
The UID of the descriptor this datum represents.
value
The value of the datum.
unit
The UID of the Unit, this datum is related to. Can be null.
Store Data
requires authentication
Store a set of records within provided Dataset Part.
Example request:
curl --request POST \
"https://app.pollinatorhub.eu/api/v1/parts/1/data" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"records\": [
{
\"timestamp\": \"2022-09-27 15:00:00\",
\"data\": [
{
\"descriptor\": \"0.0.NTSCD55\",
\"value\": \"BE100\",
\"unit\": \"kg\"
}
]
}
]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data';
$response = $client->post(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'json' => [
'records' => [
[
'timestamp' => '2022-09-27 15:00:00',
'data' => [
[
'descriptor' => '0.0.NTSCD55',
'value' => 'BE100',
'unit' => 'kg',
],
],
],
],
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/1/data"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"records": [
{
"timestamp": "2022-09-27 15:00:00",
"data": [
{
"descriptor": "0.0.NTSCD55",
"value": "BE100",
"unit": "kg"
}
]
}
]
};
fetch(url, {
method: "POST",
headers,
body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data'
payload = {
"records": [
{
"timestamp": "2022-09-27 15:00:00",
"data": [
{
"descriptor": "0.0.NTSCD55",
"value": "BE100",
"unit": "kg"
}
]
}
]
}
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
Example response (200):
{}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Delete all Data
requires authentication
Removes all data related to this Dataset Part.
Example request:
curl --request DELETE \
"https://app.pollinatorhub.eu/api/v1/parts/1/data" \
--header "Authorization: Bearer {YOUR_AUTH_KEY}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data';
$response = $client->delete(
$url,
[
'headers' => [
'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
"https://app.pollinatorhub.eu/api/v1/parts/1/data"
);
const headers = {
"Authorization": "Bearer {YOUR_AUTH_KEY}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "DELETE",
headers,
}).then(response => response.json());
import requests
import json
url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data'
headers = {
'Authorization': 'Bearer {YOUR_AUTH_KEY}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.request('DELETE', url, headers=headers)
response.json()
Example response (204):
Empty response
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.